Optimiseur de tables API - AWS Glue
  —  les types de données  —TableOptimizerTableOptimizerConfigurationTableOptimizerRunBatchGetTableOptimizerEntryBatchTableOptimizerBatchGetTableOptimizerErrorRunMetrics  —  operations  —GetTableOptimizer (get_table_optimizer)BatchGetTableOptimizer (optimiseur de table par lots)ListTableOptimizerRuns (list_table_optimizer_runs)CreateTableOptimizer (create_table_optimizer)DeleteTableOptimizer (supprimer_table_optimiseur)UpdateTableOptimizer (optimiseur de table de mise à jour)

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.

Optimiseur de tables API

L'optimiseur de table API décrit comment activer le AWS Glue API compactage afin d'améliorer les performances de lecture.

Types de données

TableOptimizer structure

Contient des détails sur un optimiseur associé à une table.

Champs

  • type— Chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table. Actuellement, la seule valeur valide est compaction.

  • configuration – Un objet TableOptimizerConfiguration.

    Un objet TableOptimizerConfiguration spécifié lors de la création ou de la mise à jour d'un optimiseur de table.

  • lastRun – Un objet TableOptimizerRun.

    Un objet TableOptimizerRun représentant la dernière exécution de l'optimiseur de table.

TableOptimizerConfiguration structure

Contient des détails sur la configuration d'un optimiseur de table. Vous transmettez cette configuration lors de la création ou de la mise à jour d'un optimiseur de table.

Champs

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

    Un rôle transmis par l'appelant qui autorise le service à mettre à jour les ressources associées à l'optimiseur au nom de l'appelant.

  • enabled – Booléen.

    Si l'optimisation des tables est activée.

TableOptimizerRun structure

Contient les détails relatifs à l'exécution d'un optimiseur de table.

Champs

  • eventType— Chaîne UTF -8 (valeurs valides : starting="STARTING" | | completed="COMPLETED" failed="FAILED" |in_progress="IN_PROGRESS").

    Un type d'événement représentant l'état de l'exécution de l'optimiseur de table.

  • startTimestamp – Horodatage.

    Représente l'horodatage de l'époque à laquelle la tâche de compactage a commencé dans Lake Formation.

  • endTimestamp – Horodatage.

    Représente l'horodatage de l'époque à laquelle la tâche de compactage s'est terminée.

  • metrics – Un objet RunMetrics.

    Un objet RunMetrics contenant des métriques pour l'exécution de l'optimiseur.

  • error— UTF -8 chaînes.

    Une erreur survenue lors de l'exécution de l'optimiseur.

BatchGetTableOptimizerEntry structure

Représente un optimiseur de table à récupérer lors de l'opération BatchGetTableOptimizer.

Champs

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

    L'ID de catalogue de la table.

  • databaseName— UTF -8 chaînes, d'au moins 1 octet de long.

    Nom de la base de données du catalogue où se trouve la table.

  • tableName— UTF -8 chaînes, d'au moins 1 octet de long.

    Nom de la table.

  • type— Chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table.

BatchTableOptimizer structure

Contient les détails de l'un des optimiseurs de table renvoyés par l'opération BatchGetTableOptimizer.

Champs

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

    L'ID de catalogue de la table.

  • databaseName— UTF -8 chaînes, d'au moins 1 octet de long.

    Nom de la base de données du catalogue où se trouve la table.

  • tableName— UTF -8 chaînes, d'au moins 1 octet de long.

    Nom de la table.

  • tableOptimizer – Un objet TableOptimizer.

    Un objet TableOptimizer qui contient des détails sur la configuration et la dernière exécution d'un optimiseur de table.

BatchGetTableOptimizerError structure

Contient des détails sur l'une des erreurs de la liste d'erreurs renvoyée par l'opération BatchGetTableOptimizer.

Champs

  • error – Un objet ErrorDetail.

    Un objet ErrorDetail contenant le code et les détails du message sur l'erreur.

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

    L'ID de catalogue de la table.

  • databaseName— UTF -8 chaînes, d'au moins 1 octet de long.

    Nom de la base de données du catalogue où se trouve la table.

  • tableName— UTF -8 chaînes, d'au moins 1 octet de long.

    Nom de la table.

  • type— Chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table.

RunMetrics structure

Métriques relatives à l'exécution de l'optimiseur.

Champs

  • NumberOfBytesCompacted— UTF -8 chaînes.

    Nombre d'octets supprimés lors de l'exécution de la tâche de compactage.

  • NumberOfFilesCompacted— UTF -8 chaînes.

    Nombre de fichiers supprimés lors de l'exécution de la tâche de compactage.

  • NumberOfDpus— UTF -8 chaînes.

    Le nombre d'DPUheures consacrées à la tâche.

  • JobDurationInHour— UTF -8 chaînes.

    Durée de la tâche en heures.

Opérations

GetTableOptimizer action (Python : get_table_optimizer)

Renvoie la configuration de tous les optimiseurs associés à une table spécifiée.

Demande

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • Type— Obligatoire : chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table.

Réponse

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • TableOptimizer – Un objet TableOptimizer.

    L'optimiseur associé à la table spécifiée.

Erreurs

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

BatchGetTableOptimizer action (Python : batch_get_table_optimizer)

Renvoie la configuration des optimiseurs de table spécifiés.

Demande

  • Entries – Obligatoire : Un tableau d'objets BatchGetTableOptimizerEntry.

    Liste d'objets BatchGetTableOptimizerEntry spécifiant les optimiseurs de table à récupérer.

Réponse
Erreurs

  • InternalServiceException

ListTableOptimizerRuns action (Python : list_table_optimizer_runs)

Répertorie l'historique des exécutions précédentes de l'optimiseur pour une table spécifique.

Demande

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • Type— Obligatoire : chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table. Actuellement, la seule valeur valide est compaction.

  • MaxResults – Nombre (entier).

    Nombre maximal d'exécutions d'optimisation à renvoyer à chaque appel.

  • NextToken— UTF -8 chaînes.

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

Réponse

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • NextToken— UTF -8 chaînes.

    Jeton de continuation pour la pagination de la liste renvoyée des exécutions de l'optimiseur, renvoyé si le segment actuel de la liste n'est pas le dernier.

  • TableOptimizerRuns – Un tableau d'objets TableOptimizerRun.

    Une liste des exécutions d'optimiseur associées à une table.

Erreurs

  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • InternalServiceException

CreateTableOptimizer action (Python : create_table_optimizer)

Crée un nouvel optimiseur de table pour une fonction spécifique. compaction est le seul type d'optimiseur actuellement pris en charge.

Demande

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • Type— Obligatoire : chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table. Actuellement, la seule valeur valide est compaction.

  • TableOptimizerConfiguration – Obligatoire : un objet TableOptimizerConfiguration.

    Un objet TableOptimizerConfiguration représentant la configuration d'un optimiseur de table.

Réponse

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

Erreurs

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

DeleteTableOptimizer action (Python : delete_table_optimizer)

Supprime un optimiseur et toutes les métadonnées associées à une table. L'optimisation ne sera plus effectuée sur la table.

Demande

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • Type— Obligatoire : chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table.

Réponse

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

Erreurs

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableOptimizer action (Python : update_table_optimizer)

Met à jour la configuration d'un optimiseur de table existant.

Demande

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

    L'ID de catalogue de la table.

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

    Nom de la base de données du catalogue où se trouve la table.

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

    Nom de la table.

  • Type— Obligatoire : chaîne UTF -8 (valeurs valides :compaction="COMPACTION").

    Le type d'optimiseur de table. Actuellement, la seule valeur valide est compaction.

  • TableOptimizerConfiguration – Obligatoire : un objet TableOptimizerConfiguration.

    Un objet TableOptimizerConfiguration représentant la configuration d'un optimiseur de table.

Réponse

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

Erreurs

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException