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. # API de table L'API de tableau décrit les types de données et les opérations associés aux tableaux. ## Types de données + [Structure de table](#aws-glue-api-catalog-tables-Table) + [TableInput structure](#aws-glue-api-catalog-tables-TableInput) + [FederatedTable structure](#aws-glue-api-catalog-tables-FederatedTable) + [Structure de colonne](#aws-glue-api-catalog-tables-Column) + [StorageDescriptor structure](#aws-glue-api-catalog-tables-StorageDescriptor) + [SchemaReference structure](#aws-glue-api-catalog-tables-SchemaReference) + [SerDeInfo structure](#aws-glue-api-catalog-tables-SerDeInfo) + [Structure de tri](#aws-glue-api-catalog-tables-Order) + [SkewedInfo structure](#aws-glue-api-catalog-tables-SkewedInfo) + [TableVersion structure](#aws-glue-api-catalog-tables-TableVersion) + [TableError structure](#aws-glue-api-catalog-tables-TableError) + [TableVersionError structure](#aws-glue-api-catalog-tables-TableVersionError) + [SortCriterion structure](#aws-glue-api-catalog-tables-SortCriterion) + [TableIdentifier structure](#aws-glue-api-catalog-tables-TableIdentifier) + [KeySchemaElement structure](#aws-glue-api-catalog-tables-KeySchemaElement) + [PartitionIndex structure](#aws-glue-api-catalog-tables-PartitionIndex) + [PartitionIndexDescriptor structure](#aws-glue-api-catalog-tables-PartitionIndexDescriptor) + [BackfillError structure](#aws-glue-api-catalog-tables-BackfillError) + [IcebergInput structure](#aws-glue-api-catalog-tables-IcebergInput) + [OpenTableFormatInput structure](#aws-glue-api-catalog-tables-OpenTableFormatInput) + [ViewDefinition structure](#aws-glue-api-catalog-tables-ViewDefinition) + [ViewDefinitionInput structure](#aws-glue-api-catalog-tables-ViewDefinitionInput) + [ViewRepresentation structure](#aws-glue-api-catalog-tables-ViewRepresentation) + [ViewRepresentationInput structure](#aws-glue-api-catalog-tables-ViewRepresentationInput) + [UpdateOpenTableFormatInput structure](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput) + [UpdateIcebergInput structure](#aws-glue-api-catalog-tables-UpdateIcebergInput) + [CreateIcebergTableInput structure](#aws-glue-api-catalog-tables-CreateIcebergTableInput) + [UpdateIcebergTableInput structure](#aws-glue-api-catalog-tables-UpdateIcebergTableInput) + [IcebergSortOrder structure](#aws-glue-api-catalog-tables-IcebergSortOrder) + [IcebergSortField structure](#aws-glue-api-catalog-tables-IcebergSortField) + [IcebergPartitionSpec structure](#aws-glue-api-catalog-tables-IcebergPartitionSpec) + [IcebergPartitionField structure](#aws-glue-api-catalog-tables-IcebergPartitionField) + [IcebergSchema structure](#aws-glue-api-catalog-tables-IcebergSchema) + [IcebergStructField structure](#aws-glue-api-catalog-tables-IcebergStructField) + [IcebergTableUpdate structure](#aws-glue-api-catalog-tables-IcebergTableUpdate) + [AuditContext structure](#aws-glue-api-catalog-tables-AuditContext) ## Structure de table Représente un ensemble de données connexes organisées en colonnes et en lignes. **Champs** + `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules. + `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-uri). Description de la table. + `Owner` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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), pas plus qu'Aucun. Durée de conservation de la table. + `StorageDescriptor` – Un Objet [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor). Descripteur de stockage contenant des informations sur le stockage physique de la table. + `PartitionKeys` : un tableau d’objets [Colonne](#aws-glue-api-catalog-tables-Column). 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` – Chaîne UTF-8, 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 une`VIRTUAL_VIEW`, une certaine Athena configuration codée en base64. + `ViewExpandedText` – Chaîne UTF-8, 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` – Chaîne UTF-8, 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\$1TABLE 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 comprend`GOVERNED`. + `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Chaque valeur est une chaîne 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 comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue de données dans lequel réside la table. + `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID de la version de tableau. + `FederatedTable` – Un objet [FederatedTable](#aws-glue-api-catalog-tables-FederatedTable). Une structure `FederatedTable` qui fait référence à une entité extérieure à AWS Glue Data Catalog. + `ViewDefinition` – Un objet [ViewDefinition](#aws-glue-api-catalog-tables-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. ## TableInput structure Structure utilisé pour définir une table. **Champs** + `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-uri). Description de la table. + `Owner` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor). Descripteur de stockage contenant des informations sur le stockage physique de la table. + `PartitionKeys` : un tableau d’objets [Colonne](#aws-glue-api-catalog-tables-Column). 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` – Chaîne UTF-8, 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 une`VIRTUAL_VIEW`, une certaine Athena configuration codée en base64. + `ViewExpandedText` – Chaîne UTF-8, 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` – Chaîne UTF-8, 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\$1TABLE 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 comprend`GOVERNED`. + `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Chaque valeur est une chaîne 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](#aws-glue-api-catalog-tables-TableIdentifier). Structure `TableIdentifier` qui décrit une table cible pour la liaison de ressources. + `ViewDefinition` – Un objet [ViewDefinitionInput](#aws-glue-api-catalog-tables-ViewDefinitionInput). Structure contenant toutes les informations qui définissent la vue, y compris le ou les dialectes de la vue, et 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 comprise entre 1 et 512 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Un identifiant unique pour la table fédérée. + `DatabaseIdentifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Un identifiant unique pour la base de données fédérée. + `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Le nom de la connexion au métastore externe. + `ConnectionType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. ## Structure de colonne Colonne d'une `Table`. **Champs** + `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Le nom de l'`Column`. + `Type` – Chaîne UTF-8, d’une longueur maximale de 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Chaque valeur est une chaîne 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](#aws-glue-api-catalog-tables-Column). 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](aws-glue-api-common.md#aws-glue-api-regex-uri). 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` – Tableau de chaînes UTF-8. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo). Les serialization/deserialization (SerDe) informations. + `BucketColumns` – Tableau de chaînes UTF-8. 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](#aws-glue-api-catalog-tables-Order). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Chaque valeur est une chaîne 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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-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](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId). Structure qui contient des champs d'identité de schéma. Ceci ou `SchemaVersionId` doit être fourni. + `SchemaVersionId` – Obligatoire : chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45). 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 serialization/deserialization programme (SerDe) qui sert d'extracteur et de chargeur. **Champs** + `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom du SerDe. + `SerializationLibrary` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Chaque valeur est une chaîne 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** + `Column` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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`). ## 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` – Tableau de chaînes UTF-8. Liste des noms de colonnes qui contiennent des valeurs biaisées. + `SkewedColumnValues` – Tableau de chaînes UTF-8. 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 clé est une chaîne UTF-8. Chaque valeur est une chaîne 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 [Table](#aws-glue-api-catalog-tables-Table). Table en question + `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules. + `ErrorDetail` – Un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-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 comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table en question. + `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-common-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 valeurs, d’une longueur comprise entre 1 et 1 024 octets. Nom du champ sur lequel trier. + `Sort` – Chaîne UTF-8 (valeurs valides : `ASC="ASCENDING"` \$1 `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue de données dans lequel réside la table. + `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la base de données du catalogue qui contient la table cible. + `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table cible. + `Region` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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** + `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom d'une clé de partition. + `Type` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Type d'une clé de partition. ## PartitionIndex structure Structure pour un index de partition. **Champs** + `Keys` – *Obligatoire :* Tableau de chaînes UTF-8, au moins 1 chaîne. Les clés de l'index de partition. + `IndexName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de l'index de partition. ## PartitionIndexDescriptor structure Descripteur d'un index de partition dans une table. **Champs** + `IndexName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de l'index de partition. + `Keys` – *Obligatoire :* Tableau d'objets [KeySchemaElement](#aws-glue-api-catalog-tables-KeySchemaElement), au moins 1 structure. Liste d'une ou plusieurs clés, sous forme de structures `KeySchemaElement`, pour l'index de partition. + `IndexStatus` – *Obligatoire* :Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `DELETING` \$1 `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](#aws-glue-api-catalog-tables-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\$10000, U\$10001, U\$10002. + InternalError: Toute erreur qui n'appartient pas à d'autres codes d'erreur. **Champs** + `Code` – Chaîne UTF-8 (valeurs valides : `ENCRYPTED_PARTITION_ERROR` \$1 `INTERNAL_ERROR` \$1 `INVALID_PARTITION_TYPE_DATA_ERROR` \$1 `MISSING_PARTITION_VALUE_ERROR` \$1 `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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList). 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** + `MetadataOperation` – *Obligatoire* : 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 comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). La version de table pour la table Iceberg. La valeur par défaut est 2. + `CreateIcebergTableInput` – Un objet [CreateIcebergTableInput](#aws-glue-api-catalog-tables-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. ## OpenTableFormatInput structure Une structure représentant un tableau au format ouvert. **Champs** + `IcebergInput` : un objet [IcebergInput](#aws-glue-api-catalog-tables-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 comprise entre 20 et 2048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Définisseur d’une vue dans SQL. + `SubObjects` : tableau de chaînes UTF-8, avec 10 chaînes maximum. Liste des tables Amazon Resource Names (ARNs). + `Representations` – tableau d’objets [ViewRepresentation](#aws-glue-api-catalog-tables-ViewRepresentation), avec 1 structure minimum et 1 000 structures maximum. 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 comprise entre 20 et 2048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Définisseur d’une vue dans SQL. + `Representations` – Tableau d’objets [ViewRepresentationInput](#aws-glue-api-catalog-tables-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. + `SubObjects` : tableau de chaînes UTF-8, avec 10 chaînes maximum. Liste des tables de base ARNs qui constituent la vue. ## ViewRepresentation structure Structure contenant le dialecte de la vue et la requête qui définit la vue. **Champs** + `Dialect` – Chaîne UTF-8 (valeurs valides : `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`). Dialecte du moteur de requête. + `DialectVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets. Version du dialecte du moteur de requête. Par exemple, 3.0.0. + `ViewOriginalText` – Chaîne UTF-8, d’une longueur maximale de 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` – Chaîne UTF-8, d’une longueur maximale de 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` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 Lake Formation. **Champs** + `Dialect` – Chaîne UTF-8 (valeurs valides : `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`). Paramètre qui indique le type de moteur d’une représentation spécifique. + `DialectVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets. Paramètre qui indique la version du moteur d’une représentation spécifique. + `ViewOriginalText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets. Chaîne qui représente la requête SQL d’origine qui décrit la vue. + `ValidationConnection` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la connexion à utiliser pour valider la représentation spécifique de la vue. + `ViewExpandedText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets. Chaîne qui représente la requête SQL qui décrit la vue avec une ressource étendue ARNs ## UpdateOpenTableFormatInput structure Paramètres d'entrée pour la mise à jour des tables au format de table ouvertes dans AWS Glue Data Catalog, servant de wrapper pour les opérations de mise à jour spécifiques au format, telles qu'Apache Iceberg. **Champs** + `UpdateIcebergInput` : un objet [UpdateIcebergInput](#aws-glue-api-catalog-tables-UpdateIcebergInput). Paramètres de mise à jour propres à Apache Iceberg 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 table. ## UpdateIcebergInput structure Paramètres d'entrée spécifiques à la mise à jour des tables Apache Iceberg dans le catalogue de AWS Glue données, contenant les opérations de mise à jour à appliquer à une table Iceberg existante. **Champs** + `UpdateIcebergTableInput` – *Obligatoire :* un objet [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-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. ## CreateIcebergTableInput structure 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** + `Location` – *Obligatoire :* chaîne de localisation, d’une longueur maximale de 2 056 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). L’emplacement S3 dans lequel les données de la table Iceberg seront stockées. + `Schema` – *Obligatoire :* un objet [IcebergSchema](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-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` – Paires clé-valeur contenant des propriétés de table supplémentaires et des paramètres de configuration pour la table Iceberg. ## UpdateIcebergTableInput structure Contient les opérations de mise à jour à appliquer à une table Iceberg existante dans le catalogue de AWS Glue données, définissant le nouvel état des métadonnées de la table. **Champs** + `Updates` – *Obligatoire :* un tableau d’objets [IcebergTableUpdate](#aws-glue-api-catalog-tables-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. ## IcebergSortOrder structure Définit la spécification de l’ordre de tri pour une table Iceberg, déterminant comment les données doivent être classées dans les partitions afin d’optimiser les performances des requêtes. **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](#aws-glue-api-catalog-tables-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. ## IcebergSortField structure Définit un champ unique dans une spécification d’ordre de tri Iceberg, y compris le champ source, la transformation, la direction du tri et l’ordre des valeurs nulles. **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 :* chaîne UTF-8. Fonction de transformation appliquée au champ source avant le tri, telle que identity, bucket ou truncate. + `Direction` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `asc="ASC"` \$1 `desc="DESC"`). La direction du tri pour ce champ, soit croissant, soit décroissant. + `NullOrder` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `nulls-first="NULLS_FIRST"` \$1 `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. ## IcebergPartitionSpec structure Définit les spécifications de partitionnement d’une table Iceberg, déterminant comment les données de la table seront organisées et partitionnées pour des performances de requête optimales. **Champs** + `Fields` – *Obligatoire :* un tableau d’objets [IcebergPartitionField](#aws-glue-api-catalog-tables-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. ## IcebergPartitionField structure Définit un champ de partition unique dans une spécification de partition Iceberg, y compris le champ source, la fonction de transformation, le nom de la partition et l’identifiant unique. **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 :* chaîne UTF-8. 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 :* chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. ## IcebergSchema structure Définit la structure du schéma d’une table Iceberg, y compris les définitions de champs, les types de données et les métadonnées du schéma. **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` – Chaîne UTF-8 (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](#aws-glue-api-catalog-tables-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. ## IcebergStructField structure Définit un champ unique dans un schéma de table Iceberg, y compris son identifiant, son nom, son type de données, son caractère nul et sa documentation. **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 :* chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Documentation facultative ou texte de description fournissant un contexte supplémentaire sur l’objectif et l’utilisation de ce champ. ## IcebergTableUpdate structure Définit un ensemble complet de mises à jour à appliquer à une table Iceberg, y compris les modifications de schéma, les modifications de partitionnement, les ajustements d’ordre de tri, les mises à jour de localisation et les modifications de propriétés. **Champs** + `Schema` – *Obligatoire :* un objet [IcebergSchema](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-uri). L’emplacement S3 mis à jour dans lequel les données de la table Iceberg seront stockées. + `Properties` – Paires clé-valeur mises à jour des propriétés de table et des paramètres de configuration pour la table Iceberg. ## AuditContext structure Structure contenant le contexte de l' Lake Formation audit. **Champs** + `AdditionalAuditContext`— Chaîne UTF-8 d'une longueur maximale de 2 048 octets. Chaîne contenant les informations contextuelles d'audit supplémentaires. + `RequestedColumns` – Tableau de chaînes UTF-8. Les colonnes demandées pour l'audit. + `AllColumnsRequested` : booléen. Toutes les colonnes font l'objet d'une demande d'audit. ## Opérations + [CreateTable action (Python : créer\$1table)](#aws-glue-api-catalog-tables-CreateTable) + [UpdateTable action (Python : update\$1table)](#aws-glue-api-catalog-tables-UpdateTable) + [DeleteTable action (Python : supprimer\$1table)](#aws-glue-api-catalog-tables-DeleteTable) + [BatchDeleteTable action (Python : batch\$1delete\$1table)](#aws-glue-api-catalog-tables-BatchDeleteTable) + [GetTable action (Python : get\$1table)](#aws-glue-api-catalog-tables-GetTable) + [GetTables action (Python : get\$1tables)](#aws-glue-api-catalog-tables-GetTables) + [GetTableVersion action (Python : get\$1table\$1version)](#aws-glue-api-catalog-tables-GetTableVersion) + [GetTableVersions action (Python : get\$1table\$1versions)](#aws-glue-api-catalog-tables-GetTableVersions) + [DeleteTableVersion action (Python : supprimer\$1table\$1version)](#aws-glue-api-catalog-tables-DeleteTableVersion) + [BatchDeleteTableVersion action (Python : batch\$1delete\$1table\$1version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion) + [SearchTables action (Python : tables de recherche)](#aws-glue-api-catalog-tables-SearchTables) + [GetPartitionIndexes action (Python : get\$1partition\$1indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes) + [CreatePartitionIndex action (Python : create\$1partition\$1index)](#aws-glue-api-catalog-tables-CreatePartitionIndex) + [DeletePartitionIndex action (Python : delete\$1partition\$1index)](#aws-glue-api-catalog-tables-DeletePartitionIndex) + [GetColumnStatisticsForTable action (Python : get\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable) + [UpdateColumnStatisticsForTable action (Python : update\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable) + [DeleteColumnStatisticsForTable action (Python : delete\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable) ## CreateTable action (Python : créer\$1table) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Identifiant unique de la table de la base de données spécifiée qui sera créée dans le catalogue de AWS Glue données. + `TableInput` – Un objet [TableInput](#aws-glue-api-catalog-tables-TableInput). Objet `TableInput` qui définit la table de métadonnées à créer dans le catalogue. + `PartitionIndexes` – Un tableau d'objets [PartitionIndex](#aws-glue-api-catalog-tables-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 comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44). ID de la transaction. + `OpenTableFormatInput` : un objet [OpenTableFormatInput](#aws-glue-api-catalog-tables-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` ## UpdateTable action (Python : update\$1table) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Identifiant unique de la table de la base de données spécifiée qui sera créée dans le catalogue de AWS Glue données. + `TableInput` – Un objet [TableInput](#aws-glue-api-catalog-tables-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 comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44). L'ID de transaction auquel le contenu de la table doit être mis à jour. + `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID de la version selon laquelle le contenu du tableau doit être mis à jour. + `ViewUpdateAction` – Chaîne UTF-8 (valeurs valides : `ADD` \$1 `REPLACE` \$1 `ADD_OR_REPLACE` \$1 `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](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput). Paramètres d'entrée pour la mise à jour des tables au format de table ouvertes 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` ## DeleteTable action (Python : supprimer\$1table) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44). 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` ## BatchDeleteTable action (Python : batch\$1delete\$1table) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 chaînes UTF-8, avec 100 chaînes maximum. Liste des tables à supprimer. + `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44). L'ID de transaction pour laquelle supprimer le contenu de la table. **Réponse** + `Errors` : un tableau d’objets [TableError](#aws-glue-api-catalog-tables-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\$1table) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44). 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](#aws-glue-api-catalog-tables-AuditContext). Structure contenant le [contexte de l' Lake Formation audit](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html). + `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 [Table](#aws-glue-api-catalog-tables-Table). Objet `Table` qui définit la table spécifiée. **Erreurs** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetTables action (Python : get\$1tables) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 2 048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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` – Chaîne UTF-8. 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 comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44). 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](#aws-glue-api-catalog-tables-AuditContext). Structure contenant le [contexte de l' Lake Formation audit](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html). + `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` – Tableau de chaînes UTF-8. 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](#aws-glue-api-catalog-tables-Table). Liste des objets `Table` demandés. + `NextToken` – Chaîne UTF-8. 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\$1table\$1version) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules. + `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](#aws-glue-api-catalog-tables-TableVersion). Version de table demandée. **Erreurs** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## GetTableVersions action (Python : get\$1table\$1versions) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules. + `NextToken` – Chaîne UTF-8. 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](#aws-glue-api-catalog-tables-TableVersion). Liste de chaînes qui identifient les versions disponibles de la table spécifiée. + `NextToken` – Chaîne UTF-8. 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\$1table\$1version) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules. + `VersionId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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\$1delete\$1table\$1version) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules. + `VersionIds` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum. 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](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Identifiant unique, composé de `account_id`. + `NextToken` – Chaîne UTF-8. Jeton de continuation, inclus s’il s’agit d’un appel de continuation. + `Filters` : un tableau d’objets [PropertyPredicate](aws-glue-api-common.md#aws-glue-api-common-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 -, :, \$1, 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](#aws-glue-api-catalog-tables-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` \$1 `ALL` \$1 `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` – Chaîne UTF-8. Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier. + `TableList` : un tableau d’objets [Table](#aws-glue-api-catalog-tables-Table). 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\$1partition\$1indexes) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue où réside la table. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Spécifie le nom d'une base de données à partir de laquelle vous souhaitez extraire des index de partition. + `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Spécifie le nom d'une table à partir de laquelle vous souhaitez extraire les index de partition. + `NextToken` – Chaîne UTF-8. Jeton de continuation, inclus s’il s’agit d’un appel de continuation. **Réponse** + `PartitionIndexDescriptorList` : un tableau d’objets [PartitionIndexDescriptor](#aws-glue-api-catalog-tables-PartitionIndexDescriptor). Liste des descripteurs d'index. + `NextToken` – Chaîne UTF-8. 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\$1partition\$1index) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue où réside la table. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Spécifie le nom d'une base de données dans laquelle vous souhaitez créer un index de partition. + `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Spécifie le nom d'une table dans laquelle vous souhaitez créer un index de partition. + `PartitionIndex` – *Obligatoire :* un objet [PartitionIndex](#aws-glue-api-catalog-tables-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\$1partition\$1index) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue où réside la table. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Spécifie le nom d'une base de données dont vous souhaitez supprimer un index de partition. + `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Spécifie le nom d'une table dont vous souhaitez supprimer un index de partition. + `IndexName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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\$1column\$1statistics\$1for\$1table) Récupère les statistiques de table des colonnes. L'autorisation Identity and Access Management (IAM) requise pour cette opération est `GetTable`. **Demande** + `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la base de données de catalogue où résident les partitions. + `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table des partitions. + `ColumnNames` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum. Une liste des noms de colonnes. **Réponse** + `ColumnStatisticsList` : un tableau d’objets [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics). Liste des ColumnStatistics. + `Errors` : un tableau d’objets [ColumnError](aws-glue-api-common.md#aws-glue-api-common-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\$1column\$1statistics\$1for\$1table) Crée ou met à jour les statistiques de table des colonnes. L'autorisation Identity and Access Management (IAM) requise pour cette opération est `UpdateTable`. **Demande** + `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la base de données de catalogue où résident les partitions. + `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table des partitions. + `ColumnStatisticsList` – *Obligatoire :* Un tableau d'objets [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics), 25 structures maximum. Liste des statistiques de la colonne. **Réponse** + `Errors` : un tableau d’objets [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError). Liste des ColumnStatisticsErrors. **Erreurs** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeleteColumnStatisticsForTable action (Python : delete\$1column\$1statistics\$1for\$1table) Récupère les statistiques de table des colonnes. L'autorisation Identity and Access Management (IAM) requise pour cette opération est `DeleteTable`. **Demande** + `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la base de données de catalogue où résident les partitions. + `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la table des partitions. + `ColumnName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Le nom de la colonne. **Réponse** + *Paramètres d’absence de réponse.* **Erreurs** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException`