API de table

• Structure de table

• TableInput structure

• FederatedTable structure

• Structure de colonne

• StorageDescriptor structure

• SchemaReference structure

• SerDeInfo structure

• Structure de tri

• SkewedInfo structure

• TableVersion structure

• TableError structure

• TableVersionError structure

• SortCriterion structure

• TableIdentifier structure

• KeySchemaElement structure

• PartitionIndex structure

• PartitionIndexDescriptor structure

• BackfillError structure

• IcebergInput structure

• OpenTableFormatInput structure

• ViewDefinition structure

• ViewDefinitionInput structure

• ViewRepresentation structure

• ViewRepresentationInput structure

• UpdateOpenTableFormatInput structure

• UpdateIcebergInput structure

• CreateIcebergTableInput structure

• UpdateIcebergTableInput structure

• IcebergSortOrder structure

• IcebergSortField structure

• IcebergPartitionSpec structure

• IcebergPartitionField structure

• IcebergSchema structure

• IcebergStructField structure

• IcebergTableUpdate structure

• IcebergTableMetadata structure

• IcebergEncryptedKey structure

• TableStatus structure

• StatusDetails structure

• ViewValidation structure

• AuditContext structure

Champs

• Name— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• DatabaseName— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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. Cette information est généralement extraite de HDFS et peut ne pas être fiable.

• LastAnalyzedTime – Horodatage.

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

• Retention : nombre (entier).

  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îne ne dépassant pas 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 unVIRTUAL_VIEW, certaines Athena configurations sont codées en base64.

• ViewExpandedText— UTF-8 chaîne ne dépassant pas 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îne ne dépassant pas 255 octets.

  Type de cette table. AWS Glue créera des tableaux 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 UTF-8 chaîne ne dépassant pas 512 000 octets.

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

• CreatedBy— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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 la requête.

• IsMultiDialectView : booléen.

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

• IsMaterializedView : booléen.

  Indique qu'une table est unMaterializedView.

• IcebergTableMetadata : un objet IcebergTableMetadata.

  Les dernières métadonnées de la table Apache Iceberg pour la table, y compris la version du format, les schémas, les spécifications de partition et les ordres de tri. Ce champ est renseigné pour les tables Iceberg et reflète l'état actuel des métadonnées Iceberg de la table.

• Status – Un objet TableStatus.

  Indique l'état d'une modification asynchrone d'une table.

Champs

• Name— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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).

  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îne ne dépassant pas 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 unVIRTUAL_VIEW, certaines Athena configurations sont codées en base64.

• ViewExpandedText— UTF-8 chaîne ne dépassant pas 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îne ne dépassant pas 255 octets.

  Type de cette table. AWS Glue créera des tableaux 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 UTF-8 chaîne ne dépassant pas 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 la requête.

Champs

• Identifier— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 512 octets, correspondant àSingle-line string pattern.

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

• DatabaseIdentifier— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 512 octets, correspondant àSingle-line string pattern.

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

• ConnectionName— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Le nom de la connexion au métastore externe.

• ConnectionType— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Type de connexion utilisé pour accéder à la table fédérée, spécifiant le protocole ou la méthode de connexion à la source de données externe.

Champs

• Name— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

  Le nom de l'Column.

• Type— UTF-8 chaîne ne dépassant pas 131072 octets, correspondant à. 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 UTF-8 chaîne ne dépassant pas 512 000 octets.

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

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 SerDeInfo.

  Les serialization/deserialization (SerDe) informations.

• 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 UTF-8 chaîne ne dépassant pas 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.

Champs

• SchemaId – Un objet SchemaId.

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

• SchemaVersionId— UTF-8 chaîne d'au moins 36 octets ou plus de 36 octets, correspondant àCustom string pattern #42.

  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.

Champs

• Name— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Nom du SerDe.

• SerializationLibrary— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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 UTF-8 chaîne ne dépassant pas 512 000 octets.

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

Champs

• Column— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Le nom de la colonne.

• SortOrder – Obligatoire : Nombre (entier), inférieur ou égal à 1.

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

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 UTF-8 chaîne.

  Chaque valeur est une UTF-8 chaîne.

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

Champs

• Table – Un objet Table.

  Table en question

• VersionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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.

Champs

• TableName— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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.

Champs

• TableName— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de la table en question.

• VersionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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.

Champs

• FieldName : chaîne de valeurs, d’une longueur comprise entre 1 et 1 024 octets.

  Nom du champ sur lequel trier.

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

  Tri croissant ou décroissant.

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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• Name— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de la table cible.

• Region— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Région de la table cible.

Champs

• Name— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Nom d'une clé de partition.

• Type— Obligatoire : UTF-8 chaîne ne dépassant pas 131072 octets, correspondant à. Single-line string pattern

  Type d'une clé de partition.

Champs

• Keys— Obligatoire : un tableau de UTF-8 chaînes, au moins une chaîne.

  Les clés de l'index de partition.

• IndexName— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de l'index de partition.

Champs

• IndexName— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de l'index de partition.

• Keys – Obligatoire : 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.

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

  Statut de l'index de partition.

  Les statuts possibles sont les suivants :

  • CRÉATION : l'index est en cours de création. Lorsqu'un index est dans un état CRÉATION, l'index ou sa table ne peut pas être supprimé.

  • ACTIVE : la création de l'index a réussi.

  • ÉCHEC : la création de l'index a échoué.

  • SUPPRESSION : 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.

• 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 la 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— UTF-8 chaîne (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 PartitionValueList.

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

Champs

• MetadataOperation— Obligatoire : UTF-8 chaîne (valeurs valides :CREATE).

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

• Version— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• CreateIcebergTableInput – Un objet CreateIcebergTableInput.

  Les paramètres de configuration requis pour créer une nouvelle table Iceberg dans le catalogue de AWS Glue données, y compris les propriétés de la table et les spécifications des métadonnées.

Champs

• IcebergInput : un objet IcebergInput.

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

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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 512 octets, correspondant àSingle-line string pattern.

  Définisseur d’une vue dans SQL.

• ViewVersionId— Numéro (long), au moins -1.

  La valeur d'ID qui identifie la version de cette vue. Pour les vues matérialisées, l'ID de version est l'ID instantané de la table Apache Iceberg.

• ViewVersionToken— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  L'ID de version de la table Apache Iceberg.

• RefreshSeconds – Nombre (long).

  Intervalle de rafraîchissement automatique en secondes pour la vue matérialisée. Si ce n'est pas spécifié, la vue ne sera pas automatiquement actualisée.

• LastRefreshType— UTF-8 chaîne (valeurs valides : FULL |INCREMENTAL).

  Définit la méthode utilisée pour la dernière actualisation.

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

  Liste de tables d’Amazon Resource Names (ARN).

• SubObjectVersionIds— Tableau d'entiers 64 bits signés, ne dépassant pas 250 chiffres.

  Liste des versions de la table Apache Iceberg référencées par la vue matérialisée.

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

  Liste de 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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 512 octets, correspondant àSingle-line string pattern.

  Définisseur d’une vue dans SQL.

• Representations – Tableau d’objets ViewRepresentationInput, avec 1 structure minimum et 10 structures maximum.

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

• ViewVersionId— Numéro (long), au moins -1.

  La valeur d'ID qui identifie la version de cette vue. Pour les vues matérialisées, l'ID de version est l'ID instantané de la table Apache Iceberg.

• ViewVersionToken— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  L'ID de version de la table Apache Iceberg.

• RefreshSeconds – Nombre (long).

  Intervalle de rafraîchissement automatique en secondes pour la vue matérialisée. Si ce n'est pas spécifié, la vue ne sera pas automatiquement actualisée.

• LastRefreshType— UTF-8 chaîne (valeurs valides : FULL |INCREMENTAL).

  Type de dernière actualisation de la vue matérialisée. Valeurs valides : Full, Incremental.

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

  Liste des ARN de table de base qui constituent la vue.

• SubObjectVersionIds— Tableau d'entiers 64 bits signés, ne dépassant pas 250 chiffres.

  Liste des versions de la table Apache Iceberg référencées par la vue matérialisée.

Champs

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

  Dialecte du moteur de requête.

• DialectVersion— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 255 octets.

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

• ViewOriginalText— UTF-8 chaîne ne dépassant pas 409 600 octets.

  Requête SELECT fournie par le client pendant CREATE VIEW DDL. Ce code SQL n’est pas utilisé lors d’une requête sur une vue (ViewExpandedText est utilisé à la place). ViewOriginalText est utilisé dans les cas comme SHOW CREATE VIEW où les utilisateurs souhaitent voir la commande DDL d’origine qui a créé la vue.

• ViewExpandedText— UTF-8 chaîne ne dépassant pas 409 600 octets.

  Code SQL étendu pour la vue. Ce code 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 transformer ViewOriginalText en ViewExpandedText. Par exemple :

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

• ValidationConnection— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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.

Champs

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

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

• DialectVersion— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 255 octets.

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

• ViewOriginalText— UTF-8 chaîne ne dépassant pas 409 600 octets.

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

• ValidationConnection— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• ViewExpandedText— UTF-8 chaîne ne dépassant pas 409 600 octets.

  Chaîne qui représente la requête SQL qui décrit la vue avec des ARN de ressources étendus.

Champs

• UpdateIcebergInput : un objet UpdateIcebergInput.

  Apache met Iceberg-specific à jour les paramètres qui définissent les modifications de table à appliquer, notamment les modifications de schéma, les spécifications de partition et les propriétés de la table.

Champs

• UpdateIcebergTableInput – Obligatoire : un objet UpdateIcebergTableInput.

  Opérations de mise à jour spécifiques à appliquer à la table Iceberg, contenant une liste de mises à jour qui définissent le nouvel état de la table, y compris le schéma, les partitions et les propriétés.

Champs

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

  L’emplacement S3 dans lequel les données de la table Iceberg seront stockées.

• Schema – Obligatoire : un objet IcebergSchema.

  Définition du schéma qui spécifie la structure, les types de champs et les métadonnées de la table Iceberg.

• PartitionSpec : un objet IcebergPartitionSpec.

  Spécification de partitionnement qui définit la manière dont les données de la table Iceberg seront organisées et partitionnées pour des performances de requête optimales.

• WriteOrder : un objet IcebergSortOrder.

  Spécification de l’ordre de tri qui définit la manière dont les données doivent être ordonnées au sein de chaque partition afin d’optimiser les performances des requêtes.

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

  Chaque touche est une UTF-8 chaîne.

  Chaque valeur est une UTF-8 chaîne.

  Key-value paires de propriétés de table supplémentaires et de paramètres de configuration pour la table Iceberg.

Champs

• Updates – Obligatoire : un tableau d’objets IcebergTableUpdate.

  Liste des opérations de mise à jour de la table qui spécifient les modifications à apporter à la table Iceberg, notamment les modifications du schéma, les spécifications de partition et les propriétés de la table.

Champs

• OrderId – Obligatoire : nombre (entier).

  Identifiant unique pour cette spécification d’ordre de tri dans les métadonnées de la table Iceberg.

• Fields – Obligatoire : un tableau d’objets IcebergSortField.

  La liste des champs et leurs directions de tri qui définissent les critères d’ordre des données de la table Iceberg.

Champs

• SourceId – Obligatoire : nombre (entier).

  Identifiant du champ source issu du schéma de table sur lequel ce champ de tri est basé.

• Transform— Obligatoire : UTF-8 chaîne.

  Fonction de transformation appliquée au champ source avant le tri, telle que identity, bucket ou truncate.

• Direction— Obligatoire : UTF-8 chaîne (valeurs valides : asc="ASC" |desc="DESC").

  La direction du tri pour ce champ, soit croissant, soit décroissant.

• NullOrder— Obligatoire : UTF-8 chaîne (valeurs valides : nulls-first="NULLS_FIRST" |nulls-last="NULLS_LAST").

  Comportement d’ordre des valeurs nulles dans ce champ, spécifiant si les valeurs nulles doivent apparaître en premier ou en dernier dans l’ordre de tri.

Champs

• Fields – Obligatoire : un tableau d’objets IcebergPartitionField.

  Liste des champs de partition qui définissent la manière dont les données de la table doivent être partitionnées, y compris les champs source et leurs transformations.

• SpecId : nombre (entier).

  Identifiant unique de cette spécification de partition dans l’historique des métadonnées de la table Iceberg.

Champs

• SourceId – Obligatoire : nombre (entier).

  Identifiant du champ source issu du schéma de table sur lequel ce champ de partition est basé.

• Transform— Obligatoire : UTF-8 chaîne.

  Fonction de transformation appliquée au champ source pour créer la partition, telle que identity, bucket, truncate, year, month, day ou hour.

• Name— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 1024 octets, correspondant àSingle-line string pattern.

  Nom du champ de partition tel qu’il apparaîtra dans la structure de la table partitionnée.

• FieldId : nombre (entier).

  Identifiant unique attribué à ce champ de partition dans la spécification de partition de la table Iceberg.

Champs

• SchemaId : nombre (entier).

  Identifiant unique de cette version de schéma dans l’historique d’évolution du schéma de la table Iceberg.

• IdentifierFieldIds : un tableau d’entiers 32 bits signés.

  Liste des identifiants de champs qui identifient de manière unique les enregistrements de la table, utilisés pour les opérations au niveau des lignes et la déduplication.

• Type— UTF-8 chaîne (valeurs valides :struct="STRUCT").

  Type de racine de la structure du schéma, généralement « struct » pour les schémas de table Iceberg.

• Fields – Obligatoire : un tableau d’objets IcebergStructField.

  Liste des définitions de champs qui constituent le schéma de table, y compris les noms, les types et les métadonnées des champs.

Champs

• Id – Obligatoire : nombre (entier).

  Identifiant unique attribué à ce champ dans le schéma de table Iceberg, utilisé pour l’évolution du schéma et le suivi des champs.

• Name— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 1024 octets, correspondant àSingle-line string pattern.

  Nom du champ tel qu’il apparaît dans le schéma de table et dans les opérations de requête.

• Type— Obligatoire : une structure vide nommée IcebergDocument.

  Définition du type de données pour ce champ, spécifiant la structure et le format des données qu’il contient.

• Required – obligatoire : booléen.

  Indique si ce champ est obligatoire (n’autorisant pas les valeurs nulles) ou facultatif (autorisant les valeurs nulles) dans le schéma de table.

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

  Documentation facultative ou texte de description fournissant un contexte supplémentaire sur l’objectif et l’utilisation de ce champ.

• InitialDefault— Une structure vide nommée. IcebergDocument

  Valeur par défaut utilisée pour renseigner la valeur du champ pour tous les enregistrements écrits avant l'ajout du champ au schéma. Cela permet une rétrocompatibilité lors de l'ajout de nouveaux champs à des tables Iceberg existantes.

• WriteDefault— Une structure vide nommée. IcebergDocument

  Valeur par défaut utilisée pour renseigner la valeur du champ pour tous les enregistrements écrits après l'ajout du champ au schéma, si le rédacteur ne fournit pas la valeur du champ. Cela peut être modifié par le biais de l'évolution du schéma.

Champs

• Schema – Obligatoire : un objet IcebergSchema.

  Définition de schéma mise à jour pour la table Iceberg, spécifiant les modifications apportées à la structure des champs, aux types de données ou aux métadonnées du schéma.

• PartitionSpec : un objet IcebergPartitionSpec.

  Spécification de partitionnement mise à jour qui définit la manière dont les données de la table doivent être réorganisées et partitionnées.

• SortOrder : un objet IcebergSortOrder.

  Spécification de l’ordre de tri mise à jour qui définit la manière dont les données doivent être ordonnées au sein des partitions afin d’optimiser les performances des requêtes.

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

  L’emplacement S3 mis à jour dans lequel les données de la table Iceberg seront stockées.

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

  Chaque touche est une UTF-8 chaîne.

  Chaque valeur est une UTF-8 chaîne.

  Paires clé-valeur mises à jour des propriétés de table et des paramètres de configuration pour la table Iceberg.

• Action— UTF-8 chaîne (valeurs valides : add-schema="ADD_SCHEMA" | set-current-schema="SET_CURRENT_SCHEMA" add-spec="ADD_SPEC" | set-default-spec="SET_DEFAULT_SPEC" | add-sort-order="ADD_SORT_ORDER" | set-default-sort-order="SET_DEFAULT_SORT_ORDER" | set-location="SET_LOCATION" | set-properties="SET_PROPERTIES" | remove-properties="REMOVE_PROPERTIES" | add-encryption-key="ADD_ENCRYPTION_KEY" |remove-encryption-key="REMOVE_ENCRYPTION_KEY").

  Type d'action de mise à jour à effectuer sur la table Iceberg. Définit l'opération spécifique telle que l'ajout d'un schéma, la définition du schéma actuel, l'ajout d'une spécification de partition ou la gestion des clés de chiffrement.

• EncryptionKey : un objet IcebergEncryptedKey.

  Informations relatives à la clé de chiffrement associées à une opération de mise à jour de la table Iceberg. Utilisé lors de l'ajout ou de la suppression de clés de chiffrement dans les métadonnées de la table lors de l'évolution de la table.

• KeyId— UTF-8 chaîne d'une longueur maximale de 2 056 octets, correspondant à. URI address multi-line string pattern

  Identifiant de la clé de chiffrement impliquée dans une opération de mise à jour de la table Iceberg. Fait référence à la clé spécifique ajoutée ou supprimée de la configuration de chiffrement de la table.

Champs

• FormatVersion— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  La version au format de table Apache Iceberg, telle que 1 ou2. Détermine l'ensemble des fonctionnalités et la disposition sur disque prises en charge par le tableau.

• TableUuid— UTF-8 chaîne, d'une longueur maximale de 100 octets, correspondant àSingle-line string pattern.

  L'identifiant unique (UUID) de la table Iceberg, attribué lors de la création de la table et utilisé pour suivre la table à travers les mises à jour des métadonnées.

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

  Emplacement S3 de base où les données et les fichiers de métadonnées de la table Iceberg sont stockés.

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

  Chaque touche est une UTF-8 chaîne.

  Chaque valeur est une UTF-8 chaîne.

  Carte de paires clé-valeur qui définissent les propriétés au niveau de la table et les paramètres de configuration de la table Iceberg.

• Schemas : un tableau d’objets IcebergSchema.

  La liste des schémas qui ont été associés à la table Iceberg au cours de son histoire, afin de soutenir l'évolution des schémas.

• CurrentSchemaId : nombre (entier).

  Identifiant du schéma actuellement actif pour la table Iceberg. Correspond à une entrée dansSchemas.

• LastColumnId : nombre (entier).

  Identifiant de colonne le plus élevé attribué dans le schéma de la table Iceberg, utilisé pour garantir des identifiants uniques lors de l'ajout de nouvelles colonnes.

• PartitionSpecs : un tableau d’objets IcebergPartitionSpec.

  Liste des spécifications de partition qui ont été associées à la table Iceberg au cours de son histoire, prenant en charge l'évolution des partitions.

• DefaultSpecId : nombre (entier).

  Identifiant de la spécification de partition actuellement utilisée par défaut lors de l'écriture de nouvelles données dans la table Iceberg.

• LastPartitionId : nombre (entier).

  Identifiant de champ de partition le plus élevé attribué dans les spécifications de partition de la table.

• SortOrders : un tableau d’objets IcebergSortOrder.

  Liste des spécifications d'ordre de tri qui ont été associées à la table Iceberg au cours de son histoire.

• DefaultSortOrderId : nombre (entier).

  Identifiant de l'ordre de tri actuellement utilisé par défaut lors de l'écriture de nouvelles données dans la table Iceberg.

Champs

• KeyId— Obligatoire : UTF-8 chaîne de caractères ne dépassant pas 2 056 octets, correspondant à. URI address multi-line string pattern

  Identifiant unique de la clé de chiffrement utilisée pour le chiffrement des tables Iceberg. Cet identifiant est utilisé pour référencer la clé dans les métadonnées de la table et pour savoir quelle clé a été utilisée pour chiffrer des données spécifiques.

• EncryptedKeyMetadata— Obligatoire : UTF-8 chaîne de caractères ne dépassant pas 2 056 octets, correspondant à. URI address multi-line string pattern

  Clé et métadonnées cryptées, encodées en base64. Le format des métadonnées clés chiffrées est déterminé par le schéma de chiffrement de la table et peut être un format encapsulé spécifique au fournisseur KMS de la table.

• EncryptedById— UTF-8 chaîne d'une longueur maximale de 2 056 octets, correspondant à. URI address multi-line string pattern

  Identifiant facultatif de la clé utilisée pour chiffrer ou encapsuler les métadonnées de la clé dans le chiffrement de table Iceberg. Ce champ fait référence à une autre clé de chiffrement qui a été utilisée pour chiffrer les métadonnées de la clé actuelle.

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

  Chaque touche est une UTF-8 chaîne.

  Chaque valeur est une UTF-8 chaîne.

  Une carte chaîne à chaîne des métadonnées supplémentaires utilisées par le schéma de chiffrement de la table. Ces propriétés fournissent un contexte et une configuration supplémentaires pour l'implémentation de la clé de chiffrement.

Champs

• RequestedBy— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  L'ARN de l'utilisateur qui a demandé la modification asynchrone.

• UpdatedBy— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  L'ARN de l'utilisateur qui a modifié manuellement le dernier changement asynchrone (demande d'annulation, etc.).

• RequestTime – Horodatage.

  Chaîne de date au format ISO 8601 indiquant l'heure à laquelle la modification a été initiée.

• UpdateTime – Horodatage.

  Chaîne de date au format ISO 8601 indiquant l'heure de dernière mise à jour de l'état.

• Action— UTF-8 chaîne (valeurs valides : UPDATE |CREATE).

  Indique quelle action a été appelée sur la table, actuellement uniquement CREATE ouUPDATE.

• State— UTF-8 chaîne (valeurs valides : QUEUED | IN_PROGRESS | SUCCESS | STOPPED |FAILED).

  Un statut générique pour la modification en cours, tel que QUEUED, IN_PROGRESS, SUCCESS ou FAILED.

• Error : un objet ErrorDetail.

  Une erreur qui n'apparaît que lorsque l'état est « ÉCHEC ». Il s'agit d'un message d'exception au niveau des parents, il peut y avoir des Error s différents pour chaque dialecte.

• Details – Un objet StatusDetails.

  Un StatusDetails objet contenant des informations sur la modification demandée.

Champs

• RequestedChange – Un objet Table.

  Un Table objet représentant les modifications demandées.

• ViewValidations : un tableau d’objets ViewValidation.

  Liste d'ViewValidationobjets contenant des informations permettant à un moteur d'analyse de valider une vue.

Champs

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

  Dialecte du moteur de requête.

• DialectVersion— UTF-8 chaîne d'une longueur d'au moins 1 et d'au plus 255 octets.

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

• ViewValidationText— UTF-8 chaîne ne dépassant pas 409 600 octets.

  SELECTRequête qui définit la vue, telle que fournie par le client.

• UpdateTime – Horodatage.

  Heure de la dernière mise à jour.

• State— UTF-8 chaîne (valeurs valides : QUEUED | IN_PROGRESS | SUCCESS | STOPPED |FAILED).

  État de la validation.

• Error : un objet ErrorDetail.

  Une erreur liée à la validation.

Champs

• AdditionalAuditContext— UTF-8 chaîne ne dépassant pas 2 048 octets.

  Chaîne contenant les informations supplémentaires sur le contexte de l'audit.

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

  Les colonnes demandées pour l'audit.

• AllColumnsRequested : booléen.

  Toutes les colonnes demandent un audit.

• CreateTable action (Python : create_table)

• UpdateTable action (Python : update_table)

• DeleteTable action (Python : delete_table)

• BatchDeleteTable action (Python : batch_delete_table)

• GetTable action (Python : get_table)

• GetTables action (Python : get_tables)

• GetTableVersion action (Python : get_table_version)

• GetTableVersions action (Python : get_table_versions)

• DeleteTableVersion action (Python : delete_table_version)

• BatchDeleteTableVersion action (Python : batch_delete_table_version)

• SearchTables action (Python : tables de recherche)

• GetPartitionIndexes action (Python : get_partition_indexes)

• CreatePartitionIndex action (Python : create_partition_index)

• DeletePartitionIndex action (Python : delete_partition_index)

• GetColumnStatisticsForTable action (Python : get_column_statistics_for_table)

• UpdateColumnStatisticsForTable action (Python : update_column_statistics_for_table)

• DeleteColumnStatisticsForTable action (Python : delete_column_statistics_for_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 dans lequel créer la Table. Si aucun élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• Name— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Identifiant unique de la table dans la base de données spécifiée qui sera créée dans le catalogue de AWS Glue données.

• TableInput – 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.

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

• TransactionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àCustom string pattern #41.

  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

• FederationSourceException

• FederationSourceRetryableException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• Name— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

  Identifiant unique de la table dans la base de données spécifiée qui sera créée dans le catalogue de AWS Glue données.

• TableInput – 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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àCustom string pattern #41.

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

• VersionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

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

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

• Force : booléen.

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

• UpdateOpenTableFormatInput : un objet UpdateOpenTableFormatInput.

  Paramètres d'entrée pour la mise à jour des tableaux au format de table ouverte dans AWS Glue Data Catalog, servant de wrapper pour les opérations de mise à jour spécifiques au format, telles qu'Apache Iceberg.

Réponse

• Paramètres d’absence de réponse.

Erreurs

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNumberLimitExceededException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

• AlreadyExistsException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• Name— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• TransactionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àCustom string pattern #41.

  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

• FederationSourceException

• FederationSourceRetryableException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• TablesToDelete— Obligatoire : tableau de UTF-8 chaînes, pas plus de 100 chaînes.

  Liste des tables à supprimer.

• TransactionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àCustom string pattern #41.

  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

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• Name— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àCustom string pattern #41.

  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.

• AuditContext : un objet AuditContext.

  Structure contenant le contexte de l' Lake Formation audit.

• IncludeStatusDetails : booléen.

  Spécifie s'il faut inclure les détails de 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.

  Indique les champs de table renvoyés par l’appel GetTable. Ce paramètre n’accepte pas une liste vide.

  Les combinaisons de valeurs valides sont les suivantes :

  • DEFAULT- Renvoie uniquement la définition de la Hive-style table.

  • LATEST_ICEBERG_METADATA- Renvoie uniquement les dernières métadonnées de la table Apache Iceberg.

  • DEFAULT, LATEST_ICEBERG_METADATA - Renvoie à la fois la définition de la Hive-style table et les dernières métadonnées de la table Apache Iceberg.

Réponse

• Table – Un Objet Table.

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

Erreurs

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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— UTF-8 chaîne ne dépassant pas 2 048 octets, correspondant à. 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 ficelle.

  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— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àCustom string pattern #41.

  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.

• AuditContext : un objet AuditContext.

  Structure contenant le contexte de l' Lake Formation audit.

• IncludeStatusDetails : booléen.

  Spécifie s'il faut inclure les détails de 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.

  Indique les champs de table renvoyés par l’appel GetTables. Ce paramètre n’accepte pas une liste vide. La demande doit inclure NAME.

  Les combinaisons de valeurs valides sont les suivantes :

  • NAME : nom de toutes les tables de la base de données.

  • NAME, TABLE_TYPE : noms de toutes les tables et des types de table.

Réponse

• TableList : un tableau d’objets Table.

  Liste des objets Table demandés.

• NextToken— UTF-8 ficelle.

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

Erreurs

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• GlueEncryptionException

• FederationSourceException

• FederationSourceRetryableException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• VersionId— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-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

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• NextToken— UTF-8 ficelle.

  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 ficelle.

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

Erreurs

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• VersionId— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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.

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• VersionIds— Obligatoire : tableau de UTF-8 chaînes, pas plus de 100 chaînes.

  Liste des ID de 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

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 ficelle.

  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 valeurs, d’une longueur comprise entre 1 et 1 024 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— UTF-8 chaîne (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 de 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 ficelle.

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

• TableList : un tableau d’objets Table.

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

Erreurs

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

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.

• DatabaseName— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• NextToken— UTF-8 ficelle.

  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 ficelle.

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

Erreurs

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

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.

• DatabaseName— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• PartitionIndex – Obligatoire : 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

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.

• DatabaseName— Obligatoire : UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant àSingle-line string pattern.

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

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• IndexName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-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

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de la table des partitions.

• ColumnNames— Obligatoire : 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 n' ColumnStatistics a pas pu être récupérée.

Erreurs

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de la table des partitions.

• ColumnStatisticsList – Obligatoire : Un tableau d'objets ColumnStatistics, 25 structures maximum.

  Liste des statistiques de la colonne.

Réponse

• Errors : un tableau d’objets ColumnStatisticsError.

  Liste des ColumnStatisticsErrors.

Erreurs

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

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 élément n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

• DatabaseName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

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

• TableName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

  Nom de la table des partitions.

• ColumnName— Obligatoire : UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant àSingle-line string pattern.

  Le nom de la colonne.

Réponse

• Paramètres d’absence de réponse.

Erreurs

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException