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
BatchGetTableOptimizer acción (Python: batch_get_table_optimizer)
ListTableOptimizerRuns acción (Python: list_table_optimizer_runs)
CreateTableOptimizer acción (Python: create_table_optimizer)
DeleteTableOptimizer acción (Python: delete_table_optimizer)
UpdateTableOptimizer acción (Python: update_table_optimizer)
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.
-
DatabaseName
— Obligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string patternEl nombre de la base de datos en el catálogo donde reside la tabla.
-
TableName
— Obligatorio: 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.
-
Type
— Obligatorio: 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
-
TableOptimizers
: matriz de objetos BatchTableOptimizer.Una lista de objetos
BatchTableOptimizer
. -
Failures
: matriz de objetos BatchGetTableOptimizerError.Una lista de errores de la operación.
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.
-
DatabaseName
— Obligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string patternEl nombre de la base de datos en el catálogo donde reside la tabla.
-
TableName
— Obligatorio: 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.
-
Type
— Obligatorio: 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.
-
DatabaseName
— Obligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string patternEl nombre de la base de datos en el catálogo donde reside la tabla.
-
TableName
— Obligatorio: 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.
-
Type
— Obligatorio: 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.
-
DatabaseName
— Obligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes, que coincidan con. Single-line string patternEl nombre de la base de datos en el catálogo donde reside la tabla.
-
TableName
— Obligatorio: 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.
-
Type
— Obligatorio: 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.
-
DatabaseName
— Obligatorio: UTF -8 cadenas, de no menos de 1 ni más de 255 bytes de longitud, que coincidan con. Single-line string patternEl nombre de la base de datos en el catálogo donde reside la tabla.
-
TableName
— Obligatorio: 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.
-
Type
— Obligatorio: 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