Optimizador de tablas API - AWS Glue

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Optimizador de tablas API

El optimizador de tablas API describe cómo permitir la compactación AWS Glue API para mejorar el rendimiento de lectura.

Tipos de datos

TableOptimizer estructura

Contiene detalles sobre un optimizador asociado a una tabla.

Campos
  • type— UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla. El único valor válido actualmente es compaction.

  • configuration: un objeto TableOptimizerConfiguration.

    Un objeto TableOptimizerConfiguration que se especificó al crear o actualizar un optimizador de tablas.

  • lastRun: un objeto TableOptimizerRun.

    Un objeto TableOptimizerRun que representa la última ejecución del optimizador de tablas.

TableOptimizerConfiguration estructura

Contiene detalles sobre la configuración de un optimizador de tablas. Esta configuración se transfiere al crear o actualizar un optimizador de tablas.

Campos
  • roleArn— UTF -8 cadenas, de no menos de 1 ni más de 512 bytes de longitud, que coinciden conSingle-line string pattern.

    Un rol transferido por la persona que llama y que permite al servicio actualizar los recursos asociados al optimizador en nombre de la persona que llama.

  • enabled: booleano.

    Si la optimización de tablas está habilitada.

TableOptimizerRun estructura

Contiene detalles de una ejecución del optimizador de tablas.

Campos
  • eventType— UTF -8 cadenas (valores válidos: starting="STARTING" | completed="COMPLETED" | failed="FAILED" |in_progress="IN_PROGRESS").

    Un tipo de evento que representa el estado de la ejecución del optimizador de tablas.

  • startTimestamp: marca temporal.

    Representa la marca temporal de la época en la que se inició el trabajo de compactación en Lake Formation.

  • endTimestamp: marca temporal.

    Representa la marca temporal de la época en la que finalizó el trabajo de compactación.

  • metrics: un objeto RunMetrics.

    Un objeto RunMetrics que contiene las métricas de la ejecución del optimizador.

  • error— UTF -8 cadenas.

    Un error que se produjo durante la ejecución del optimizador.

BatchGetTableOptimizerEntry estructura

Representa un optimizador de tablas que se va a recuperar en la operación BatchGetTableOptimizer.

Campos
  • catalogId: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • databaseName— UTF -8 cadenas de al menos 1 byte de longitud.

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • tableName— UTF -8 cadenas de al menos 1 byte de longitud.

    El nombre de la tabla.

  • type— UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla.

BatchTableOptimizer estructura

Contiene detalles de uno de los optimizadores de tablas devueltos por la operación BatchGetTableOptimizer.

Campos
  • catalogId: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • databaseName— UTF -8 cadenas de al menos 1 byte de longitud.

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • tableName— UTF -8 cadenas de al menos 1 byte de longitud.

    El nombre de la tabla.

  • tableOptimizer: un objeto TableOptimizer.

    Un objeto TableOptimizer que contiene detalles sobre la configuración y la última ejecución de un optimizador de tabla.

BatchGetTableOptimizerError estructura

Contiene detalles sobre uno de los errores de la lista de errores devuelta por la operación BatchGetTableOptimizer.

Campos
  • error: un objeto ErrorDetail.

    Un objeto ErrorDetail que contiene detalles de mensaje y código acerca del error.

  • catalogId: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • databaseName— UTF -8 cadenas de al menos 1 byte de longitud.

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • tableName— UTF -8 cadenas de al menos 1 byte de longitud.

    El nombre de la tabla.

  • type— UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla.

RunMetrics estructura

Métricas de la ejecución del optimizador.

Campos
  • NumberOfBytesCompacted— UTF -8 cuerdas.

    El número de bytes eliminados por la ejecución del trabajo de compactación.

  • NumberOfFilesCompacted— UTF -8 cuerdas.

    El número de archivos eliminados por la ejecución del trabajo de compactación.

  • NumberOfDpus— UTF -8 cuerdas.

    El número de DPU horas consumidas por el trabajo.

  • JobDurationInHour— UTF -8 cuerdas.

    La duración del trabajo en horas.

Operaciones

GetTableOptimizer acción (Python: get_table_optimizer)

Devuelve la configuración de todos los optimizadores asociados a una tabla especificada.

Solicitud
  • CatalogId: Obligatorio: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string pattern

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan conSingle-line string pattern.

    El nombre de la tabla.

  • TypeObligatorio: UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla.

Respuesta
  • CatalogId: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseName— UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coinciden conSingle-line string pattern.

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableName— UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coinciden conSingle-line string pattern.

    El nombre de la tabla.

  • TableOptimizer: un objeto TableOptimizer.

    El optimizador asociado a la tabla especificada.

Errores
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

BatchGetTableOptimizer acción (Python: batch_get_table_optimizer)

Devuelve la configuración de los optimizadores de la tabla especificados.

Solicitud
  • Entries (obligatorio): una matriz de objetos BatchGetTableOptimizerEntry.

    Una lista de objetos BatchGetTableOptimizerEntry que especifican los optimizadores de tabla que se van a recuperar.

Respuesta
Errores
  • InternalServiceException

ListTableOptimizerRuns acción (Python: list_table_optimizer_runs)

Muestra el historial de las ejecuciones anteriores del optimizador para una tabla específica.

Solicitud
  • CatalogId: Obligatorio: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string pattern

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan conSingle-line string pattern.

    El nombre de la tabla.

  • TypeObligatorio: UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla. El único valor válido actualmente es compaction.

  • MaxResults: número (entero).

    El número máximo de ejecuciones del optimizador que se devolverán en cada llamada.

  • NextToken— UTF -8 cadenas.

    Token de continuación si se trata de una llamada de continuidad.

Respuesta
  • CatalogId: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseName— UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coinciden conSingle-line string pattern.

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableName— UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coinciden conSingle-line string pattern.

    El nombre de la tabla.

  • NextToken— UTF -8 cadenas.

    Token de continuación para paginar la lista obtenida; se devuelve si el segmento actual de la lista no es el último.

  • TableOptimizerRuns: matriz de objetos TableOptimizerRun.

    Lista de las ejecuciones del optimizador asociadas a una tabla.

Errores
  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • InternalServiceException

CreateTableOptimizer acción (Python: create_table_optimizer)

Crea un nuevo optimizador de tablas para una función específica. compaction es el único tipo de optimizador compatible actualmente.

Solicitud
  • CatalogId: Obligatorio: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string pattern

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan conSingle-line string pattern.

    El nombre de la tabla.

  • TypeObligatorio: UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla. El único valor válido actualmente es compaction.

  • TableOptimizerConfiguration: obligatorio: objeto TableOptimizerConfiguration.

    Un objeto TableOptimizerConfiguration que representa la configuración de un optimizador de tablas.

Respuesta
  • Sin parámetros de respuesta.

Errores
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

DeleteTableOptimizer acción (Python: delete_table_optimizer)

Elimina un optimizador y todos los metadatos asociados a una tabla. La optimización ya no se realizará en la tabla.

Solicitud
  • CatalogId: Obligatorio: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes, que coincidan con. Single-line string pattern

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan conSingle-line string pattern.

    El nombre de la tabla.

  • TypeObligatorio: UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla.

Respuesta
  • Sin parámetros de respuesta.

Errores
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableOptimizer acción (Python: update_table_optimizer)

Actualiza la configuración de un optimizador de tablas existente.

Solicitud
  • CatalogId: Obligatorio: cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.

    El ID de catálogo de la tabla.

  • DatabaseNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string pattern

    El nombre de la base de datos en el catálogo donde reside la tabla.

  • TableNameObligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan conSingle-line string pattern.

    El nombre de la tabla.

  • TypeObligatorio: UTF -8 cadenas (valores válidos:compaction="COMPACTION").

    El tipo de optimizador de tabla. El único valor válido actualmente es compaction.

  • TableOptimizerConfiguration: obligatorio: objeto TableOptimizerConfiguration.

    Un objeto TableOptimizerConfiguration que representa la configuración de un optimizador de tablas.

Respuesta
  • Sin parámetros de respuesta.

Errores
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException