Tableau API - AWS Glue

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tableau API

Le tableau API décrit les types de données et les opérations associés aux tables.

Types de données

Structure de table

Représente un ensemble de données connexes organisées en colonnes et en lignes.

Champs
  • NameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • DatabaseName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la base de données où résident les métadonnées de table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • Description – Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    Description de la table.

  • Owner— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Propriétaire de la table.

  • CreateTime – Horodatage.

    Date de création de la définition de table dans le catalogue de données.

  • UpdateTime – Horodatage.

    Date de la dernière mise à jour de la table.

  • LastAccessTime – Horodatage.

    Date du dernier accès à la table. Cela provient HDFS généralement de et peut ne pas être fiable.

  • LastAnalyzedTime – Horodatage.

    Dernière date de calcul des statistiques de colonne pour cette table.

  • Retention – Nombre (entier), pas plus qu'Aucun.

    Durée de conservation de la table.

  • StorageDescriptor – Un Objet StorageDescriptor.

    Descripteur de stockage contenant des informations sur le stockage physique de la table.

  • PartitionKeys – Un tableau d'objets Colonne.

    Liste de colonnes par laquelle la table est partitionnée. Seuls les types primitifs sont pris en charge en tant que clés de partition.

    Lorsque vous créez un tableau utilisé par Amazon Athena et que vous ne spécifiez pas de partitionKeys, vous devez au moins régler la valeur de partitionKeys à une liste vide. Par exemple :

    "PartitionKeys": []

  • ViewOriginalText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations. Si la table est uneVIRTUAL_VIEW, une certaine Athena configuration codée en base64.

  • ViewExpandedText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations.

  • TableType— UTF -8 chaînes, d'une longueur maximale de 255 octets.

    Type de cette table. AWS Glue créera des tables avec le EXTERNAL_TABLE type. D'autres services, tels que Athena, peuvent créer des tables avec des types de tables supplémentaires.

    AWS Glue types de tables associés :

    EXTERNAL_TABLE

    Attribut compatible avec Hive : indique une table non gérée par Hive.

    GOVERNED

    Utilisé par AWS Lake Formation. Le catalogue AWS Glue de données comprendGOVERNED.

  • Parameters – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne de clé, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne de UTF -8, d'une longueur maximale de 512 000 octets.

    Ces paires clé-valeur définissent les propriétés associées à la table.

  • CreatedBy— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Personne ou entité qui a créé la table.

  • IsRegisteredWithLakeFormation – Booléen.

    Indique si la table a été enregistrée auprès de AWS Lake Formation.

  • TargetTable – Un objet TableIdentifier.

    Structure TableIdentifier qui décrit une table cible pour la liaison de ressources.

  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données dans lequel réside la table.

  • VersionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    ID de la version de tableau.

  • FederatedTable – Un objet FederatedTable.

    Une structure FederatedTable qui fait référence à une entité extérieure à AWS Glue Data Catalog.

  • ViewDefinition – Un objet ViewDefinition.

    Structure contenant toutes les informations qui définissent la vue, y compris le ou les dialectes de la vue et de la requête.

  • IsMultiDialectView – Booléen.

    Spécifie si la vue prend en charge les SQL dialectes d'un ou de plusieurs moteurs de requête différents et peut donc être lue par ces moteurs.

TableInput structure

Structure utilisé pour définir une table.

Champs
  • NameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table. Pour des raisons de compatibilité avec Hive, ce nom est converti en minuscules lors de son stockage.

  • Description – Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    Description de la table.

  • Owner— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Propriétaire de la table. Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations.

  • LastAccessTime – Horodatage.

    Date du dernier accès à la table.

  • LastAnalyzedTime – Horodatage.

    Dernière date de calcul des statistiques de colonne pour cette table.

  • Retention – Nombre (entier), pas plus qu'Aucun.

    Durée de conservation de la table.

  • StorageDescriptor – Un Objet StorageDescriptor.

    Descripteur de stockage contenant des informations sur le stockage physique de la table.

  • PartitionKeys – Un tableau d'objets Colonne.

    Liste de colonnes par laquelle la table est partitionnée. Seuls les types primitifs sont pris en charge en tant que clés de partition.

    Lorsque vous créez un tableau utilisé par Amazon Athena et que vous ne spécifiez pas de partitionKeys, vous devez au moins régler la valeur de partitionKeys à une liste vide. Par exemple :

    "PartitionKeys": []

  • ViewOriginalText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations. Si la table est uneVIRTUAL_VIEW, une certaine Athena configuration codée en base64.

  • ViewExpandedText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations.

  • TableType— UTF -8 chaînes, d'une longueur maximale de 255 octets.

    Type de cette table. AWS Glue créera des tables avec le EXTERNAL_TABLE type. D'autres services, tels que Athena, peuvent créer des tables avec des types de tables supplémentaires.

    AWS Glue types de tables associés :

    EXTERNAL_TABLE

    Attribut compatible avec Hive : indique une table non gérée par Hive.

    GOVERNED

    Utilisé par AWS Lake Formation. Le catalogue AWS Glue de données comprendGOVERNED.

  • Parameters – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne de clé, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne de UTF -8, d'une longueur maximale de 512 000 octets.

    Ces paires clé-valeur définissent les propriétés associées à la table.

  • TargetTable – Un objet TableIdentifier.

    Structure TableIdentifier qui décrit une table cible pour la liaison de ressources.

  • ViewDefinition – Un objet ViewDefinitionInput.

    Structure contenant toutes les informations qui définissent la vue, y compris le ou les dialectes de la vue et de la requête.

FederatedTable structure

Une table qui pointe vers une entité extérieure à AWS Glue Data Catalog.

Champs
  • Identifier— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 512 octets, correspondant auSingle-line string pattern.

    Un identifiant unique pour la table fédérée.

  • DatabaseIdentifier— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 512 octets, correspondant auSingle-line string pattern.

    Un identifiant unique pour la base de données fédérée.

  • ConnectionName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Le nom de la connexion au métastore externe.

Structure de colonne

Colonne d'une Table.

Champs
  • NameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Le nom de l'Column.

  • Type— Chaîne UTF -8, d'une longueur maximale de 131072 octets, correspondant au. Single-line string pattern

    Le type de données de Column.

  • Comment – Chaîne de commentaire, d'une longueur maximale de 255 octets, correspondant au Single-line string pattern.

    Commentaire au format de texte libre.

  • Parameters – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne de clé, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne de UTF -8, d'une longueur maximale de 512 000 octets.

    Ces paires clé-valeur définissent les propriétés associées à la colonne.

StorageDescriptor structure

Décrit le stockage physique des données de table.

Champs
  • Columns – Un tableau d'objets Colonne.

    Liste des Columns de la table.

  • Location – Chaîne de localisation, d'une longueur maximale de 2 056 octets, correspondant au URI address multi-line string pattern.

    Emplacement physique de la table. Par défaut, il prend la forme de l'emplacement de entrepôt, suivie de l'emplacement de la base de données dans l'entrepôt, suivi du nom de la table.

  • AdditionalLocations— Un tableau de UTF -8 chaînes.

    Liste des emplacements pointant vers le chemin d'accès où se trouve une table Delta.

  • InputFormat – Chaîne de format, d'une longueur maximale de 128 octets, correspondant au Single-line string pattern.

    Format d'entrée : SequenceFileInputFormat (binaire) ou TextInputFormat ou format personnalisé.

  • OutputFormat – Chaîne de format, d'une longueur maximale de 128 octets, correspondant au Single-line string pattern.

    Format de sortie : SequenceFileOutputFormat (binaire) ou IgnoreKeyTextOutputFormat ou format personnalisé.

  • Compressed – Booléen.

    True si les données de la table sont compressées ou False si elles ne le sont pas.

  • NumberOfBuckets – Nombre (entier).

    Doit être spécifié si la table contient des colonnes de dimension.

  • SerdeInfo – Un objet SerDeInfos.

    Les informations de sérialisation/désérialisation (). SerDe

  • BucketColumns— Un tableau de UTF -8 chaînes.

    Liste de colonnes de regroupement de réducteur, de colonnes de clustérisation et de colonnes de mise en compartiment de la table.

  • SortColumns – Un tableau d'objets Ordre.

    Liste spécifiant l'ordre de tri de chaque compartiment de la table.

  • Parameters – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne de clé, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne de UTF -8, d'une longueur maximale de 512 000 octets.

    Propriétés fournies par l'utilisateur sous la forme clé-valeur.

  • SkewedInfo – Un objet SkewedInfo.

    Informations concernant les valeurs qui apparaissent fréquemment dans une colonne (valeurs asymétriques).

  • StoredAsSubDirectories – Booléen.

    True si les données de la table sont stockées dans les sous-répertoires ou False dans le cas contraire.

  • SchemaReference – Un objet SchemaReference.

    Objet qui fait référence à un schéma stocké dans le registre des AWS Glue schémas.

    Lors de la création d'une table, vous pouvez transmettre une liste vide de colonnes pour le schéma et plutôt utiliser une référence de schéma.

SchemaReference structure

Objet qui fait référence à un schéma stocké dans le registre des AWS Glue schémas.

Champs
  • SchemaId – Un objet SchemaId.

    Structure qui contient des champs d'identité de schéma. Ceci ou SchemaVersionId doit être fourni.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID unique affecté à une version du schéma. Ceci ou SchemaId doit être fourni.

  • SchemaVersionNumber – Nombre (long), compris entre 1 et 100 000.

    Numéro de version du schéma.

SerDeInfo structure

Informations sur un programme de sérialisation/désérialisation (SerDe) qui sert d'extracteur et de chargeur.

Champs
  • Name— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom du SerDe.

  • SerializationLibrary— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Généralement, la classe qui implémente le SerDe. Par exemple : org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

  • Parameters – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne de clé, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne de UTF -8, d'une longueur maximale de 512 000 octets.

    Ces paires clé-valeur définissent les paramètres d'initialisation pour. SerDe

Structure de tri

Indique l'ordre de tri d'une colonne triée.

Champs
  • ColumnObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Le nom de la colonne.

  • SortOrderObligatoire : Nombre (entier), inférieur ou égal à 1.

    Indique que la colonne est triée en ordre croissant (== 1) ou en ordre décroissant(==0).

SkewedInfo structure

Spécifie les valeurs biaisées d'une table. Les valeurs biaisées sont celles qui se produisent à très haute fréquence.

Champs
  • SkewedColumnNames— Un tableau de UTF -8 chaînes.

    Liste des noms de colonnes qui contiennent des valeurs biaisées.

  • SkewedColumnValues— Un tableau de UTF -8 chaînes.

    Liste des valeurs qui apparaissent si fréquemment qu'elles sont considérées comme biaisées.

  • SkewedColumnValueLocationMaps – Tableau de mappage de paires valeur-clé.

    Chaque touche est une chaîne de caractères UTF -8.

    Chaque valeur est une chaîne de caractères UTF -8.

    Mappage de valeurs biaisées avec les colonnes qui les contiennent.

TableVersion structure

Spécifie une version d'une table.

Champs
  • Table – Un objet Tableau.

    Table en question

  • VersionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Valeur d'ID qui identifie cette version de table. Un VersionId est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

TableError structure

Enregistrement d'erreur pour les opérations de table.

Champs
  • TableName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • ErrorDetail – Un objet ErrorDetail.

    Détails relatifs à l'erreur.

TableVersionError structure

Enregistrement d'erreur pour les opérations de version table.

Champs
  • TableName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la table en question.

  • VersionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Valeur d'ID de la version en question. Un VersionID est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

  • ErrorDetail – Un objet ErrorDetail.

    Détails relatifs à l'erreur.

SortCriterion structure

Spécifie un champ selon lequel trier et un ordre de tri.

Champs
  • FieldName – Chaîne de valeur, d'une longueur maximale de 1024 octets.

    Nom du champ sur lequel trier.

  • Sort— Chaîne UTF -8 (valeurs valides : ASC="ASCENDING" |DESC="DESCENDING").

    Tri croissant ou décroissant.

TableIdentifier structure

Structure qui décrit une table cible pour la liaison de ressources.

Champs
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données dans lequel réside la table.

  • DatabaseName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la base de données du catalogue qui contient la table cible.

  • Name— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la table cible.

  • Region— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Région de la table cible.

KeySchemaElement structure

Une paire de clés de partition composée d'un nom et d'un type.

Champs
  • NameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom d'une clé de partition.

  • TypeObligatoire : UTF -8 chaînes, d'une longueur maximale de 131072 octets, correspondant au. Single-line string pattern

    Type d'une clé de partition.

PartitionIndex structure

Structure pour un index de partition.

Champs
  • KeysObligatoire : un tableau de UTF -8 chaînes, dont au moins une chaîne.

    Les clés de l'index de partition.

  • IndexNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de l'index de partition.

PartitionIndexDescriptor structure

Descripteur d'un index de partition dans une table.

Champs
  • IndexNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de l'index de partition.

  • KeysObligatoire : Tableau d'objets KeySchemaElement, au moins 1 structure.

    Liste d'une ou plusieurs clés, sous forme de structures KeySchemaElement, pour l'index de partition.

  • IndexStatusObligatoire : chaîne UTF -8 (valeurs valides : CREATING | ACTIVE | DELETING |FAILED).

    Statut de l'index de partition.

    Les statuts possibles sont les suivants :

    • CREATING: L'index est en cours de création. Lorsqu'un index est dans un CREATING état, l'index ou sa table ne peuvent pas être supprimés.

    • ACTIVE: la création de l'index est réussie.

    • FAILED: La création de l'index échoue.

    • DELETING: L'index est supprimé de la liste des index.

  • BackfillErrors – Un tableau d'objets BackfillError.

    Liste d'erreurs qui peuvent se produire lors de l'enregistrement d'index de partition pour une table existante.

BackfillError structure

Liste d'erreurs qui peuvent se produire lors de l'enregistrement d'index de partition pour une table existante.

Ces erreurs donnent les détails sur la raison pour laquelle un enregistrement d'index a échoué et fournissent un nombre limité de partitions dans la réponse, de sorte que vous pouvez corriger les partitions défaillantes et essayer d'enregistrer à nouveau l'index. Les erreurs les plus courantes pouvant se produire sont classées comme suit :

  • EncryptedPartitionError: Les partitions sont cryptées.

  • InvalidPartitionTypeDataError: La valeur de la partition ne correspond pas au type de données de cette colonne de partition.

  • MissingPartitionValueError: Les partitions sont cryptées.

  • UnsupportedPartitionCharacterError: Les caractères contenus dans la valeur de partition ne sont pas pris en charge. Par exemple : U+0000, U+0001, U+0002.

  • InternalError: Toute erreur qui n'appartient pas à d'autres codes d'erreur.

Champs
  • Code— Chaîne UTF -8 (valeurs valides : ENCRYPTED_PARTITION_ERROR | | INTERNAL_ERROR | INVALID_PARTITION_TYPE_DATA_ERROR MISSING_PARTITION_VALUE_ERROR |UNSUPPORTED_PARTITION_CHARACTER_ERROR).

    Code d'erreur correspondant à une erreur survenue lors de l'enregistrement d'index de partition pour une table existante.

  • Partitions – Un tableau d'objets PartitionValueListe.

    Liste d'un nombre limité de partitions dans la réponse.

IcebergInput structure

Une structure qui définit une table de métadonnées Apache Iceberg à créer dans le catalogue.

Champs
  • MetadataOperationObligatoire : chaîne UTF -8 (valeurs valides :CREATE).

    Une opération de métadonnées obligatoire. Ne peut être défini que sur CREATE.

  • Version— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    La version de table pour la table Iceberg. La valeur par défaut est 2.

OpenTableFormatInput structure

Une structure représentant un tableau au format ouvert.

Champs
  • IcebergInput – Un objet IcebergInput.

    Spécifie une structure IcebergInput qui définit une table de métadonnées Apache Iceberg.

ViewDefinition structure

Structure contenant les détails des représentations.

Champs
  • IsProtected – Booléen.

    Vous pouvez définir cet indicateur sur true pour indiquer au moteur de ne pas transférer les opérations fournies par l'utilisateur dans le plan logique de la vue lors de la planification des requêtes. Cependant, le réglage de cet indicateur ne garantit pas que le moteur sera conforme. Reportez-vous à la documentation du moteur pour comprendre les garanties fournies, le cas échéant.

  • Definer— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 512 octets, correspondant auSingle-line string pattern.

    Le définisseur d'une vue dans. SQL

  • SubObjects— Un tableau de UTF -8 chaînes, pas plus de 10 chaînes.

    Liste des tables Amazon Resource Names (ARNs).

  • Representations – tableau d'objets ViewRepresentation, avec 1 structure minimum et 1 000 structures maximum.

    Une liste de représentations.

ViewDefinitionInput structure

Structure contenant les détails relatifs à la création ou à la mise à jour d'une AWS Glue vue.

Champs
  • IsProtected – Booléen.

    Vous pouvez définir cet indicateur sur true pour indiquer au moteur de ne pas transférer les opérations fournies par l'utilisateur dans le plan logique de la vue lors de la planification des requêtes. Cependant, le réglage de cet indicateur ne garantit pas que le moteur sera conforme. Reportez-vous à la documentation du moteur pour comprendre les garanties fournies, le cas échéant.

  • Definer— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 512 octets, correspondant auSingle-line string pattern.

    Le définisseur d'une vue dans. SQL

  • Representations— Un ensemble d'ViewRepresentationInputobjets, composé d'au moins 1 ou de plus de 10 structures.

    Liste de structures contenant le dialecte de la vue et la requête qui définit la vue.

  • SubObjects— Un tableau de UTF -8 chaînes, pas plus de 10 chaînes.

    Liste des tables de base ARNs qui constituent la vue.

ViewRepresentation structure

Structure qui contient le dialecte de la vue et la requête qui définit la vue.

Champs
  • Dialect— Chaîne UTF -8 (valeurs valides : REDSHIFT | ATHENA |SPARK).

    Le dialecte du moteur de requête.

  • DialectVersion— UTF -8 chaînes, d'une longueur d'au moins 1 ou supérieure à 255 octets.

    Version du dialecte du moteur de requête. Par exemple, 3.0.0.

  • ViewOriginalText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    La SELECT requête fournie par le client pendantCREATE VIEW DDL. Ceci n'SQLest pas utilisé lors d'une requête sur une vue (ViewExpandedTextil est utilisé à la place). ViewOriginalTextest utilisé dans les cas SHOW CREATE VIEW où les utilisateurs souhaitent voir la DDL commande d'origine qui a créé la vue.

  • ViewExpandedText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Ils ont été développés SQL pour la vue. Ceci SQL est utilisé par les moteurs lors du traitement d'une requête sur une vue. Les moteurs peuvent effectuer des opérations lors de la création de la vue pour la transformer ViewOriginalText enViewExpandedText. Par exemple :

    • Identifiants entièrement qualifiés : SELECT * from table1 -> SELECT * from db1.table1

  • ValidationConnection— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la connexion à utiliser pour valider la représentation spécifique de la vue.

  • IsStale – Booléen.

    Les dialectes marqués comme périmés ne sont plus valides et doivent être mis à jour avant de pouvoir être interrogés dans leurs moteurs de requêtes respectifs.

ViewRepresentationInput structure

Structure contenant les détails d'une représentation pour mettre à jour ou créer une vue de Lake Formation.

Champs
  • Dialect— Chaîne UTF -8 (valeurs valides : REDSHIFT | ATHENA |SPARK).

    Paramètre qui indique le type de moteur d'une représentation spécifique.

  • DialectVersion— UTF -8 chaînes, d'une longueur d'au moins 1 ou supérieure à 255 octets.

    Paramètre qui indique la version du moteur d'une représentation spécifique.

  • ViewOriginalText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Chaîne qui représente la SQL requête d'origine qui décrit la vue.

  • ValidationConnection— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Nom de la connexion à utiliser pour valider la représentation spécifique de la vue.

  • ViewExpandedText— UTF -8 chaînes, d'une longueur maximale de 409 600 octets.

    Une chaîne qui représente la SQL requête qui décrit la vue avec une ressource étendue ARNs

Opérations

CreateTable action (Python : créer_table)

Crée une nouvelle définition de table dans le catalogue de données.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données dans lequel créer la Table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Base de données du catalogue dans laquelle créer la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TableInputObligatoire : un objet TableInput.

    Objet TableInput qui définit la table de métadonnées à créer dans le catalogue.

  • PartitionIndexes – Un tableau d'objets PartitionIndex, 3 structures au maximum.

    Liste d'index de partition, structures de type PartitionIndex, à créer dans la table.

  • TransactionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #16.

    ID de la transaction.

  • OpenTableFormatInput – Un objet OpenTableFormatInput.

    Spécifie une structure OpenTableFormatInput lors de la création d'un tableau au format ouvert.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • AlreadyExistsException

  • InvalidInputException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • ConcurrentModificationException

  • ResourceNotReadyException

UpdateTable action (Python : update_table)

Met à jour une table de métadonnées dans le catalogue de données.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TableInputObligatoire : un objet TableInput.

    Objet TableInput mis à jour qui définit la table de métadonnées du catalogue.

  • SkipArchive – Booléen.

    Par défaut, UpdateTable crée toujours une version archivée de la table avant de la mettre à jour. Toutefois, si skipArchive a la valeur true, UpdateTable ne crée pas la version archivée.

  • TransactionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #16.

    L'ID de transaction auquel le contenu de la table doit être mis à jour.

  • VersionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    L'ID de la version selon laquelle le contenu du tableau doit être mis à jour.

  • ViewUpdateAction— Chaîne UTF -8 (valeurs valides : ADD | | REPLACE ADD_OR_REPLACE |DROP).

    Opération à effectuer lors de la mise à jour de la vue.

  • Force – Booléen.

    Un indicateur qui peut être défini sur true pour ignorer les exigences de correspondance entre le descripteur de stockage et le sous-objet correspondants.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

  • ResourceNotReadyException

DeleteTable action (Python : supprimer_table)

Supprime une définition de table du catalogue de données.

Note

Après avoir effectué cette opération, vous n'avez plus accès aux versions et partitions de table appartenant à la table supprimée. AWS Glue supprime ces ressources « orphelines » de manière asynchrone en temps opportun, à la discrétion du service.

Pour garantir la suppression immédiate de toutes les ressources connexes, avant d'appeler DeleteTable, utilisez DeleteTableVersion ou BatchDeleteTableVersion, et DeletePartition ou BatchDeletePartition, pour supprimer les ressources appartenant à la table.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • NameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table à supprimer. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TransactionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #16.

    L'ID de transaction pour laquelle supprimer le contenu de la table.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

  • ResourceNotReadyException

BatchDeleteTable action (Python : batch_delete_table)

Supprime plusieurs tables à la fois.

Note

Après avoir effectué cette opération, vous n'avez plus accès aux versions et partitions de table appartenant à la table supprimée. AWS Glue supprime ces ressources « orphelines » de manière asynchrone en temps opportun, à la discrétion du service.

Pour garantir la suppression immédiate de toutes les ressources connexes, avant d'appeler BatchDeleteTable, utilisez DeleteTableVersion ou BatchDeleteTableVersion, et DeletePartition ou BatchDeletePartition, pour supprimer les ressources appartenant à la table.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données de catalogue où résident les tables à supprimer. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TablesToDeleteObligatoire : un tableau de UTF -8 chaînes, pas plus de 100 chaînes.

    Liste des tables à supprimer.

  • TransactionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #16.

    L'ID de transaction pour laquelle supprimer le contenu de la table.

Réponse
  • Errors – Un tableau d'objets TableError.

    Liste des erreurs survenues dans la tentative de supprimer les tables spécifiées.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • ResourceNotReadyException

GetTable action (Python : get_table)

Extrait la définition de Table d'un catalogue de données pour une table spécifiée.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • NameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table pour laquelle récupérer la définition. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TransactionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #16.

    L'ID de transaction pour laquelle lire le contenu de la table.

  • QueryAsOfTime – Horodatage.

    L'Heure à laquelle lire le contenu de la table. S'il n'est pas défini, l'heure de validation de transaction la plus récente sera utilisée. Ne peut pas être spécifié avec TransactionId.

  • IncludeStatusDetails – Booléen.

    Spécifie s'il faut inclure les détails du statut relatifs à une demande de création ou de mise à jour d'une vue du catalogue de AWS Glue données.

Réponse
  • Table – Un Objet Tableau.

    Objet Table qui définit la table spécifiée.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • ResourceNotReadyException

  • FederationSourceException

  • FederationSourceRetryableException

GetTables action (Python : get_tables)

Récupère les définitions de tout ou partie des tables dans une Database donnée.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Base de données du catalogue dont les tables doivent être affichées. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • Expression— Chaîne UTF -8, d'une longueur maximale de 2048 octets, correspondant au. Single-line string pattern

    Modèle d'expression régulière. S'il est présent, seules les tables dont les noms correspondent au modèle sont renvoyées.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, inclus s'il s'agit d'un appel de continuation.

  • MaxResults – Nombre (entier), compris entre 1 et 100.

    Nombre maximal de tables à renvoyer dans une seule réponse.

  • TransactionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #16.

    L'ID de transaction pour laquelle lire le contenu de la table.

  • QueryAsOfTime – Horodatage.

    L'Heure à laquelle lire le contenu de la table. S'il n'est pas défini, l'heure de validation de transaction la plus récente sera utilisée. Ne peut pas être spécifié avec TransactionId.

  • IncludeStatusDetails – Booléen.

    Spécifie s'il faut inclure les détails du statut relatifs à une demande de création ou de mise à jour d'une vue du catalogue de AWS Glue données.

  • AttributesToGet— Un tableau de UTF -8 chaînes.

    Spécifie les champs de table renvoyés par l'GetTablesappel. Ce paramètre n'accepte pas une liste vide. La demande doit inclureNAME.

    Les combinaisons de valeurs valides sont les suivantes :

    • NAME- Noms de toutes les tables de la base de données.

    • NAME, TABLE_TYPE - Noms de toutes les tables et des types de tables.

Réponse
  • TableList – Un tableau d'objets Tableau.

    Liste des objets Table demandés.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • GlueEncryptionException

  • FederationSourceException

  • FederationSourceRetryableException

GetTableVersion action (Python : get_table_version)

Extrait une version spécifiée d'une table.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • VersionId— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auSingle-line string pattern.

    Valeur d'ID de la version de table à récupérer. Un VersionID est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

Réponse
  • TableVersion – Un objet TableVersion.

    Version de table demandée.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

GetTableVersions action (Python : get_table_versions)

Extrait une liste de chaînes qui identifient les versions disponibles d'une table spécifiée.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, s'il ne s'agit pas du premier appel.

  • MaxResults – Nombre (entier), compris entre 1 et 100.

    Nombre maximal de versions de table à renvoyer dans une réponse.

Réponse
  • TableVersions – Un tableau d'objets TableVersion.

    Liste de chaînes qui identifient les versions disponibles de la table spécifiée.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, si la liste des version disponibles n'inclut pas la dernière version.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeleteTableVersion action (Python : supprimer_table_version)

Supprime une version spécifiée d'une table.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • VersionIdObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    ID de la version de table à supprimer. Un VersionID est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchDeleteTableVersion action (Python : batch_delete_table_version)

Supprime un lot spécifié de versions d'une table.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

  • VersionIdsObligatoire : un tableau de UTF -8 chaînes, pas plus de 100 chaînes.

    Liste IDs des versions à supprimer. Un VersionId est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

Réponse
  • Errors – Un tableau d'objets TableVersionError.

    Liste des erreurs survenues lors de la tentative de suppression des versions de table spécifiées.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

SearchTables action (Python : tables de recherche)

Recherche un ensemble de tables en fonction des propriétés figurant dans les métadonnées de table, ainsi que dans la base de données parent. Vous pouvez effectuer une recherche sur des conditions de texte ou de filtre.

Vous pouvez uniquement obtenir les tables auxquelles vous avez accès en fonction des stratégies de sécurité définies dans Lake Formation. Vous avez besoin d'au moins un accès en lecture seule à la table pour qu'elle soit renvoyée. Si vous n'avez pas accès à toutes les colonnes de la table, ces colonnes ne feront pas l'objet d'une recherche lorsque la liste des tables vous sera renvoyée. Si vous avez accès aux colonnes, mais pas aux données des colonnes, ces colonnes et les métadonnées associées pour ces colonnes seront incluses dans la recherche.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Identifiant unique, composé de account_id.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, inclus s'il s'agit d'un appel de continuation.

  • Filters – Un tableau d'objets PropertyPredicate.

    Liste de paires clé-valeur et comparateur utilisé pour filtrer les résultats de recherche. Renvoie toutes les entités correspondant au prédicat.

    Le membre Comparator du struct PropertyPredicate est utilisé uniquement pour les champs temporels et peut être omis pour d'autres types de champs. En outre, lors de la comparaison de valeurs de chaîne, par exemple lorsque Key=Name, un algorithme de correspondance floue (fuzzy match) est utilisé. Le champ Key (par exemple, la valeur du champ Name) est divisé en jetons sur certains caractères de ponctuation, par exemple -, :, #, etc.. Ensuite, chaque jeton est comparé de manière exacte à un membre Value de PropertyPredicate. Par exemple, si Key=Name et Value=link, les tables nommées customer-link et xx-link-yy sont retournés, mais xxlinkyy ne l'est pas.

  • SearchText – Chaîne de valeur, d'une longueur maximale de 1024 octets.

    Chaîne utilisée pour une recherche de texte.

    La spécification d'une valeur entre guillemets filtre en fonction d'une correspondance exacte avec cette valeur.

  • SortCriteria – Un tableau d'objets SortCriterion, pas plus d'une structure.

    Liste de critères de tri des résultats par un nom de champ, dans un ordre croissant ou décroissant.

  • MaxResults – Nombre (entier), compris entre 1 et 1 000.

    Nombre maximal de tables à renvoyer dans une seule réponse.

  • ResourceShareType— Chaîne UTF -8 (valeurs valides : FOREIGN | ALL |FEDERATED).

    Permet de spécifier que vous souhaitez rechercher les tables partagées avec votre compte. Les valeurs autorisées sont FOREIGN ou ALL.

    • Si défini sur FOREIGN, effectuera une recherche dans les tables partagées avec votre compte.

    • Si défini sur ALL, effectuera une recherche dans les tables partagées avec votre compte, ainsi que les tables dans votre compte local.

  • IncludeStatusDetails – Booléen.

    Spécifie s'il faut inclure les détails du statut relatifs à une demande de création ou de mise à jour d'une vue du catalogue de AWS Glue données.

Réponse
  • NextToken— UTF -8 chaînes.

    Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.

  • TableList – Un tableau d'objets Tableau.

    Liste des objets Table demandés. La réponse SearchTables renvoie uniquement les tables auxquelles vous avez accès.

Erreurs
  • InternalServiceException

  • InvalidInputException

  • OperationTimeoutException

GetPartitionIndexes action (Python : get_partition_indexes)

Récupère les index de partition associés à une table.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue où réside la table.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Spécifie le nom d'une base de données à partir de laquelle vous souhaitez extraire des index de partition.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Spécifie le nom d'une table à partir de laquelle vous souhaitez extraire les index de partition.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, inclus s'il s'agit d'un appel de continuation.

Réponse
  • PartitionIndexDescriptorList – Un tableau d'objets PartitionIndexDescriptor.

    Liste des descripteurs d'index.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.

Erreurs
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

  • EntityNotFoundException

  • ConflictException

CreatePartitionIndex action (Python : create_partition_index)

Crée un index de partition spécifié dans une table existante.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue où réside la table.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Spécifie le nom d'une base de données dans laquelle vous souhaitez créer un index de partition.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Spécifie le nom d'une table dans laquelle vous souhaitez créer un index de partition.

  • PartitionIndexObligatoire : un objet PartitionIndex.

    Spécifie une structure PartitionIndex pour créer un index de partition dans une table existante.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • AlreadyExistsException

  • InvalidInputException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeletePartitionIndex action (Python : delete_partition_index)

Supprime un index de partition spécifié d'une table existante.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue où réside la table.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Spécifie le nom d'une base de données dont vous souhaitez supprimer un index de partition.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Spécifie le nom d'une table dont vous souhaitez supprimer un index de partition.

  • IndexNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de l'index de partition à supprimer.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

  • EntityNotFoundException

  • ConflictException

  • GlueEncryptionException

GetColumnStatisticsForTable action (Python : get_column_statistics_for_table)

Récupère les statistiques de table des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération estGetTable.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données de catalogue où résident les partitions.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table des partitions.

  • ColumnNamesObligatoire : un tableau de UTF -8 chaînes, pas plus de 100 chaînes.

    Une liste des noms de colonnes.

Réponse
  • ColumnStatisticsList – Un tableau d'objets ColumnStatistics.

    Liste des ColumnStatistics.

  • Errors – Un tableau d'objets ColumnError.

    La liste de ces ColumnStatistics informations n'a pas pu être récupérée.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

UpdateColumnStatisticsForTable action (Python : update_column_statistics_for_table)

Crée ou met à jour les statistiques de table des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération estUpdateTable.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données de catalogue où résident les partitions.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table des partitions.

  • ColumnStatisticsListObligatoire : Un tableau d'objets ColumnStatistics, 25 structures maximum.

    Liste des statistiques de la colonne.

Réponse
Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeleteColumnStatisticsForTable action (Python : delete_column_statistics_for_table)

Récupère les statistiques de table des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération estDeleteTable.

Demande
  • CatalogId – Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

  • DatabaseNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la base de données de catalogue où résident les partitions.

  • TableNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Nom de la table des partitions.

  • ColumnNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auSingle-line string pattern.

    Le nom de la colonne.

Réponse
  • Paramètres d'absence de réponse.

Erreurs
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException