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.
API de tabla
La API de tabla describe los tipos de datos y las operaciones que se asocian a las tablas.
Tipos de datos
Estructura de tabla
Representa una recopilación de datos relacionados organizados en columnas y filas.
Campos
-
Name: obligatorio: cadena UTF-8, 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 nombre de la tabla. Para su compatibilidad con Hive, este debe estar completamente en minúsculas.
-
DatabaseName: cadena UTF-8, 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 nombre de la base de datos de metadatos donde residen los metadatos de la tabla. Para su compatibilidad con Hive, este debe estar completamente en minúsculas.
-
Description: cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.Una descripción de la tabla.
-
Owner: cadena UTF-8, 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 propietario de la tabla.
-
CreateTime: marca temporal.La hora de creación de la definición de la tabla en el Catálogo de datos.
-
UpdateTime: marca temporal.La última vez que se actualizó la tabla.
-
LastAccessTime: marca temporal.La última vez que se accedió a tabla. Esta suele tomarse de HDFS y podría no ser de confianza.
-
LastAnalyzedTime: marca temporal.La última vez que se calcularon las estadísticas de columna para esta tabla.
-
Retention: número (entero), cero como máximo.El tiempo de retención para esta tabla.
-
StorageDescriptor: objeto StorageDescriptor.Un descriptor de almacenamiento que contiene información acerca del almacenamiento físico de esta tabla.
-
PartitionKeys: matriz de objetos Columna.Una lista de columnas por las que se particiona la tabla. Solo se admiten los tipos primitivos como claves de partición.
Cuando se crea una tabla utilizada por Amazon Athena, y no especifica ninguna
partitionKeys, al menos debe establecer el valor departitionKeysen una lista vacía. Por ejemplo:"PartitionKeys": [] -
ViewOriginalText: cadena UTF-8 de 409600 bytes de largo como máximo.Se incluye para permitir la compatibilidad con Apache Hive. No se utiliza en el transcurso normal de las operaciones de AWS Glue. Si la tabla es una
VIRTUAL_VIEW, ciertos parámetros de configuración de Athena se codifican en base64. -
ViewExpandedText: cadena UTF-8 de 409600 bytes de largo como máximo.Se incluye para permitir la compatibilidad con Apache Hive. No se utiliza en el transcurso normal de las operaciones de AWS Glue.
-
TableType: cadena UTF-8 de 255 bytes de largo como máximo.El tipo de esta tabla. AWS Glue creará tablas del tipo
EXTERNAL_TABLE. Es posible que otros servicios, como Athena, creen tablas de otros tipos.Tipos de tablas relacionados con AWS Glue:
- EXTERNAL_TABLE
-
Atributo de compatibilidad con Hive: indica una tabla no gestionada por Hive.
- GOVERNED
-
Utilizado por AWS Lake Formation. El Catálogo de datos de AWS Glue entiende
GOVERNED.
-
Parameters: matriz de mapas de pares clave-valor.Cada clave es una cadena de claves con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es una cadena UTF-8 que no tiene más de 512000 bytes de largo.
Estos pares clave-valor definen las propiedades asociadas a la tabla.
-
CreatedBy: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La persona o entidad que creó la tabla.
-
IsRegisteredWithLakeFormation: booleano.Indica si la tabla se ha registrado con AWS Lake Formation.
-
TargetTable: objeto TableIdentifier.Estructura
TableIdentifierque describe una tabla de destino para la vinculación de recursos. -
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.ID del Catálogo de datos donde reside la tabla.
-
VersionId: cadena UTF-8, 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 la versión de la tabla.
-
FederatedTable: objeto FederatedTable.Una estructura
FederatedTableque hace referencia a una entidad externa aAWS Glue Data Catalog.
Estructura TableInput
Una estructura utilizada para definir una tabla.
Campos
-
Name: obligatorio: cadena UTF-8, 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 nombre de la tabla. Para su compatibilidad con Hive, este se incorpora en minúsculas al almacenarse.
-
Description: cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.Una descripción de la tabla.
-
Owner: cadena UTF-8, 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 propietario de la tabla. Se incluye para permitir la compatibilidad con Apache Hive. No se utiliza en el transcurso normal de las operaciones de AWS Glue.
-
LastAccessTime: marca temporal.La última vez que se accedió a tabla.
-
LastAnalyzedTime: marca temporal.La última vez que se calcularon las estadísticas de columna para esta tabla.
-
Retention: número (entero), cero como máximo.El tiempo de retención para esta tabla.
-
StorageDescriptor: objeto StorageDescriptor.Un descriptor de almacenamiento que contiene información acerca del almacenamiento físico de esta tabla.
-
PartitionKeys: matriz de objetos Columna.Una lista de columnas por las que se particiona la tabla. Solo se admiten los tipos primitivos como claves de partición.
Cuando se crea una tabla utilizada por Amazon Athena, y no especifica ninguna
partitionKeys, al menos debe establecer el valor departitionKeysen una lista vacía. Por ejemplo:"PartitionKeys": [] -
ViewOriginalText: cadena UTF-8 de 409600 bytes de largo como máximo.Se incluye para permitir la compatibilidad con Apache Hive. No se utiliza en el transcurso normal de las operaciones de AWS Glue. Si la tabla es una
VIRTUAL_VIEW, ciertos parámetros de configuración de Athena se codifican en base64. -
ViewExpandedText: cadena UTF-8 de 409600 bytes de largo como máximo.Se incluye para permitir la compatibilidad con Apache Hive. No se utiliza en el transcurso normal de las operaciones de AWS Glue.
-
TableType: cadena UTF-8 de 255 bytes de largo como máximo.El tipo de esta tabla. AWS Glue creará tablas del tipo
EXTERNAL_TABLE. Es posible que otros servicios, como Athena, creen tablas de otros tipos.Tipos de tablas relacionados con AWS Glue:
- EXTERNAL_TABLE
-
Atributo de compatibilidad con Hive: indica una tabla no gestionada por Hive.
- GOVERNED
-
Utilizado por AWS Lake Formation. El Catálogo de datos de AWS Glue entiende
GOVERNED.
-
Parameters: matriz de mapas de pares clave-valor.Cada clave es una cadena de claves con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es una cadena UTF-8 que no tiene más de 512000 bytes de largo.
Estos pares clave-valor definen las propiedades asociadas a la tabla.
-
TargetTable: objeto TableIdentifier.Estructura
TableIdentifierque describe una tabla de destino para la vinculación de recursos.
Estructura de FederatedTable
Una tabla que apunta a una entidad externa a AWS Glue Data Catalog.
Campos
-
Identifier: cadena UTF-8, con 1 byte de largo como mínimo y 512 bytes de largo como máximo, que coincide con el Single-line string pattern.Un identificador único para la tabla federada.
-
DatabaseIdentifier: cadena UTF-8, con 1 byte de largo como mínimo y 512 bytes de largo como máximo, que coincide con el Single-line string pattern.Un identificador único para la base de datos federada.
-
ConnectionName: cadena UTF-8, 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 nombre de la conexión al metalmacén externo.
Estructura de las columnas
Una columna en una Table.
Campos
-
Name: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre del elemento
Column. -
Type: cadena UTF-8 con un máximo de 131072 bytes de largo, que coincide con el Single-line string pattern.El tipo de datos de la
Column. -
Comment: cadena de comentario de un máximo de 255 bytes de largo, que coincide con el Single-line string pattern.Un comentario de texto de formato libre.
-
Parameters: matriz de mapas de pares clave-valor.Cada clave es una cadena de claves con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es una cadena UTF-8 que no tiene más de 512000 bytes de largo.
Estos pares clave-valor. definen las propiedades asociadas a la columna.
Estructura StorageDescriptor
Describe el almacenamiento físico de los datos de la tabla.
Campos
-
Columns: matriz de objetos Columna.Una lista de las
Columnsde la tabla. -
Location: cadena de ubicación de un máximo de 2056 bytes de largo, que coincide con el URI address multi-line string pattern.Ubicación física de la tabla. De forma predeterminada, adopta la forma de la ubicación de almacén, seguida de la ubicación de la base de datos en el almacén, seguida del nombre de tabla.
-
AdditionalLocations: matriz de cadenas UTF-8.Lista de ubicaciones que apuntan a la ruta en la que se encuentra una tabla Delta.
-
InputFormat: cadena de formato de un máximo de 128 bytes de largo, que coincide con el Single-line string pattern.Formato de entrada:
SequenceFileInputFormat(binario),TextInputFormato formato personalizado. -
OutputFormat: cadena de formato de un máximo de 128 bytes de largo, que coincide con el Single-line string pattern.Formato de salida:
SequenceFileOutputFormat(binario),IgnoreKeyTextOutputFormato formato personalizado. -
Compressed: booleano.Truesi los datos de la tabla están comprimidos oFalsesi no. -
NumberOfBuckets: número (entero).Debe especificarse si la tabla contiene alguna columna de dimensión.
-
SerdeInfo: objeto SerDeInfo.La información de serialización y deserialización (SerDe).
-
BucketColumns: matriz de cadenas UTF-8.Lista de columnas de agrupamiento del reductor, columnas de clústeres y columnas de almacenamiento en bucket de la tabla.
-
SortColumns: matriz de objetos Order.Una lista donde se especifica el orden de clasificación de cada bucket en la tabla.
-
Parameters: matriz de mapas de pares clave-valor.Cada clave es una cadena de claves con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es una cadena UTF-8 que no tiene más de 512000 bytes de largo.
Las propiedades facilitadas por el usuario en formato clave-valor.
-
SkewedInfo: objeto SkewedInfo.La información sobre los valores que aparecen con frecuencia en una columna (valores sesgados).
-
StoredAsSubDirectories: booleano.Truesi los datos de la tabla se almacenan en subdirectorios oFalsesi no. -
SchemaReference: objeto SchemaReference.Objeto que hace referencia a un esquema almacenado en AWS Glue Schema Registry.
Al crear una tabla, puede pasar una lista vacía de columnas para el esquema y, en su lugar, utilizar una referencia de esquema.
Estructura SchemaReference
Objeto que hace referencia a un esquema almacenado en AWS Glue Schema Registry.
Campos
-
SchemaId: objeto SchemaId.Estructura que contiene campos de identidad de esquema. Este o el
SchemaVersionIdtiene que ser proporcionado. -
SchemaVersionId: cadena UTF-8, con 36 bytes de largo como mínimo y 36 bytes de largo como máximo, que coincide con el Custom string pattern #12.El ID único asignado a una versión del esquema. Este o el
SchemaIdtiene que ser proporcionado. -
SchemaVersionNumber: número (largo) que no es inferior a 1 ni es superior a 100 000.El número de versión del esquema.
Estructura SerDeInfo
Información sobre un programa de serialización y deserialización (SerDe) que sirve de extractor y cargador.
Campos
-
Name: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre del SerDe.
-
SerializationLibrary: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.En general, la clase que implementa el SerDe. Un ejemplo es
org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe. -
Parameters: matriz de mapas de pares clave-valor.Cada clave es una cadena de claves con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es una cadena UTF-8 que no tiene más de 512000 bytes de largo.
Estos pares de clave-valor definen parámetros de inicialización para el SerDe.
Estructura Order
Especifica el orden de clasificación de una columna ordenada.
Campos
-
Column: obligatorio: cadena UTF-8, 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 nombre de la columna.
-
SortOrder– Obligatorio: número (entero), uno como máximo.Indica que la columna se clasifica en orden ascendente (
== 1) o descendente (==0).
Estructura SkewedInfo
Especifica valores sesgados en una tabla. Los valores sesgados son los que se producen con una frecuencia muy alta.
Campos
-
SkewedColumnNames: matriz de cadenas UTF-8.Una lista de nombres de columnas que contienen valores de sesgado.
-
SkewedColumnValues: matriz de cadenas UTF-8.Una lista de valores que aparecen con tanta frecuencia como para considerarse de sesgado.
-
SkewedColumnValueLocationMaps: matriz de mapas de pares clave-valor.Cada clave es una cadena UTF-8.
Cada valor es una cadena UTF-8.
Un mapeo de valores de sesgado a las columnas que los contienen.
Estructura TableVersion
Especifica una versión de una tabla.
Campos
-
Table: objeto Tabla.La tabla en cuestión.
-
VersionId: cadena UTF-8, 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 valor de ID que identifica la versión de esta tabla. Una
VersionIdes una representación de cadena de un número entero. Cada versión se incrementa en 1.
Estructura TableError
Un registro de error para las operaciones con tablas.
Campos
-
TableName: cadena UTF-8, 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 nombre de la tabla. Para su compatibilidad con Hive, este debe estar completamente en minúsculas.
-
ErrorDetail: objeto ErrorDetail.Los detalles sobre el error.
Estructura TableVersionError
Un registro de error para las operaciones con versiones de tablas.
Campos
-
TableName: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre de la tabla en cuestión.
-
VersionId: cadena UTF-8, 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 valor de ID de la versión en cuestión. Una
VersionIDes una representación de cadena de un número entero. Cada versión se incrementa en 1. -
ErrorDetail: objeto ErrorDetail.Los detalles sobre el error.
Estructura SortCriterion
Especifica un campo por el que se va a ordenar y un orden de clasificación.
Campos
-
FieldName: cadena de valor, de 1024 bytes de largo como máximo.El nombre del campo en el que se va a ordenar.
-
Sort: cadena UTF-8 (valores válidos:ASC="ASCENDING"|DESC="DESCENDING").Orden ascendente o descendente.
Estructura TableIdentifier
Estructura que describe una tabla de destino para la vinculación de recursos.
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.ID del Catálogo de datos donde reside la tabla.
-
DatabaseName: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre de la base de datos del catálogo que contiene la tabla de destino.
-
Name: cadena UTF-8, 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 nombre de la tabla de destino.
-
Region: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Región de la tabla objetivo.
Estructura KeySchemaElement
Un par de claves de partición que consta de un nombre y un tipo.
Campos
-
Name: obligatorio: cadena UTF-8, 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 nombre de una clave de partición.
-
Type– Obligatorio: cadena UTF-8, de 131 072 bytes de largo como máximo, que coincide con Single-line string pattern.El tipo de una clave de partición.
Estructura PartitionIndex
Una estructura para un índice de partición.
Campos
-
Keys: obligatorio: matriz de cadenas UTF-8, con una cadena como mínimo.Las claves para el índice de partición.
-
IndexName: obligatorio: cadena UTF-8, 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 nombre del índice de partición.
Estructura PartitionIndexDescriptor
Un descriptor para un índice de partición en una tabla.
Campos
-
IndexName: obligatorio: cadena UTF-8, 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 nombre del índice de partición.
-
Keys– Obligatorio: una matriz de objetos KeySchemaElement, 1 estructura como mínimo.Una lista de una o más claves, como estructuras
KeySchemaElement, para el índice de partición. -
IndexStatus– Obligatorio: cadena UTF-8 (valores válidos:CREATING|ACTIVE|DELETING|FAILED).El estado del índice de partición.
Los posibles estados son:
-
CREACIÓN: el índice se está creando. Cuando el índice está en un estado CREACIÓN, el índice o su tabla no se pueden eliminar.
-
ACTIVO: la creación del índice se realiza correctamente.
-
ERROR: error en la creación del índice.
-
ELIMINACIÓN: el índice se elimina de la lista de índices.
-
-
BackfillErrors: matriz de objetos BackFillError.Una lista de los errores que pueden producirse al registrar índices de particiones para una tabla existente.
Estructura BackFillError
Una lista de los errores que pueden producirse al registrar índices de particiones para una tabla existente.
Estos errores dan los detalles acerca de por qué un registro de índice presentó error y proporcionan un número limitado de particiones en la respuesta, de modo que pueda corregir las particiones con errores e intentar registrar el índice de nuevo. El conjunto más común de errores que pueden ocurrir se clasifican de la siguiente manera:
-
EncryptedPartitionError: las particiones están cifradas.
-
InvalidPartitionTypeDataError: el valor de las particiones no coincide con el tipo de datos de esa columna de partición.
-
MissingPartitionValueError: las particiones están cifradas.
-
UnsupportedPartitionCharacterError: no se admiten caracteres dentro del valor de partición. Por ejemplo: U+0000, U+0001, U+0002.
-
InternalError: cualquier error que no pertenezca a otros códigos de error.
Campos
-
Code: cadena UTF-8 (valores válidos:ENCRYPTED_PARTITION_ERROR|INTERNAL_ERROR|INVALID_PARTITION_TYPE_DATA_ERROR|MISSING_PARTITION_VALUE_ERROR|UNSUPPORTED_PARTITION_CHARACTER_ERROR).Una lista de los errores que ocurrieron al registrar índices de particiones para una tabla existente.
-
Partitions: matriz de objetos PartitionValueList.Una lista de un número limitado de particiones en la respuesta.
Estructura de IcebergInput
Una estructura que define una tabla de metadatos de Apache Iceberg para crearla en el catálogo.
Campos
-
MetadataOperation– Obligatorio: cadena UTF-8 (valores válidos:CREATE).Una operación de metadatos obligatoria. Esto solo se puede configurar en
CREATE. -
Version: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La versión de tabla para la tabla de Iceberg. El valor predeterminado es 2.
Estructura de OpenTableFormatInput
Una estructura que representa una tabla de formato abierto.
Campos
-
IcebergInput: objeto IcebergInput.Especifica una estructura
IcebergInputque define una tabla de metadatos de Apache Iceberg.
Operaciones
Acción BatchDeleteTableVersion (Python: batch_delete_table_version)
Acción CreatePartitionIndex (Python: create_partition_index)
Acción DeletePartitionIndex (Python: delete_partition_index)
Acción GetColumnStatisticsForTable (Python: get_column_statistics_for_table)
Acción UpdateColumnStatisticsForTable (Python: update_column_statistics_for_table)
Acción DeleteColumnStatisticsForTable (Python: delete_column_statistics_for_table)
Acción CreateTable (Python: create_table)
Crea una nueva definición de tabla en el Catálogo de datos.
Solicitud
-
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 del Catálogo de datos donde se crea la
Table. Si no se proporciona ninguno, el ID de cuenta de AWS se usará de forma predeterminada. -
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos de catálogos en la que se crea la nueva tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TableInput: obligatorio: objeto TableInput.Objeto
TableInputque define la tabla de metadatos que se va a crear en el catálogo. -
PartitionIndexes: matriz de objetos PartitionIndex, con 3 estructuras como máximo.Una lista de índices de particiones, estructuras
PartitionIndex, para crear en la tabla. -
TransactionId: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Custom string pattern #11.El ID de la transacción.
-
OpenTableFormatInput: objeto OpenTableFormatInput.Especifica una estructura
OpenTableFormatInputal crear una tabla de formato abierto.
Respuesta
Sin parámetros de respuesta.
Errores
AlreadyExistsExceptionInvalidInputExceptionEntityNotFoundExceptionResourceNumberLimitExceededExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionExceptionConcurrentModificationExceptionResourceNotReadyException
Acción UpdateTable (Python: update_table)
Actualiza una tabla de metadatos en el Catálogo de datos.
Solicitud
-
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 del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos de catálogos donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TableInput: obligatorio: objeto TableInput.Objeto
TableInputactualizado para definir la tabla de metadatos en el catálogo. -
SkipArchive: booleano.De forma predeterminada,
UpdateTablecrea siempre una versión archivada de la tabla antes de actualizarla. SiskipArchivese establece en true, sin embargo,UpdateTableno crea la versión archivada. -
TransactionId: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Custom string pattern #11.ID de transacción en el que se va a actualizar el contenido de la tabla.
-
VersionId: cadena UTF-8, 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 la versión a la que se actualizará el contenido de la tabla.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionConcurrentModificationExceptionResourceNumberLimitExceededExceptionGlueEncryptionExceptionResourceNotReadyException
Acción DeleteTable (Python: delete_table)
Quita una definición de tabla del Catálogo de datos.
nota
Después de completar esta operación, ya no tendrá acceso a las versiones de la tabla y a las particiones que pertenecen a la tabla. AWS Glue elimina estos recursos “huérfanos” de manera asíncrona en forma oportuna, a discreción del servicio.
Para asegurarse de la eliminación inmediata de todos los recursos relacionados, antes de llamar a DeleteTable, use DeleteTableVersion o BatchDeleteTableVersion y DeletePartition o BatchDeletePartition, para eliminar todos los recursos que pertenezcan a la tabla.
Solicitud
-
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 del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos de catálogos donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
Name: obligatorio: cadena UTF-8, 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 nombre de la tabla que se eliminará. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TransactionId: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Custom string pattern #11.ID de transacción en el que se va a eliminar el contenido de la tabla.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionConcurrentModificationExceptionResourceNotReadyException
Acción BatchDeleteTable (Python: batch_delete_table)
Elimina varias tablas a la vez.
nota
Después de completar esta operación, ya no tendrá acceso a las versiones de la tabla y a las particiones que pertenecen a la tabla. AWS Glue elimina estos recursos “huérfanos” de manera asíncrona en forma oportuna, a discreción del servicio.
Para asegurarse de la eliminación inmediata de todos los recursos relacionados, antes de llamar a BatchDeleteTable, use DeleteTableVersion o BatchDeleteTableVersion y DeletePartition o BatchDeletePartition, para eliminar todos los recursos que pertenezcan a la tabla.
Solicitud
-
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 del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos de catálogos donde residen las tablas que se van a eliminar. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TablesToDelete– Obligatorio: matriz de cadenas UTF-8, con 100 cadenas como máximo.Una lista de las tablas que se van a eliminar.
-
TransactionId: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Custom string pattern #11.ID de transacción en el que se va a eliminar el contenido de la tabla.
Respuesta
-
Errors: matriz de objetos TableError.Una lista de errores encontrados al intentar eliminar las tablas especificadas.
Errores
InvalidInputExceptionEntityNotFoundExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionExceptionResourceNotReadyException
Acción GetTable (Python: get_table)
Recupera la definición de Table en un Catálogo de datos para una tabla especificada.
Solicitud
-
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 del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos en el catálogo donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
Name: obligatorio: cadena UTF-8, 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 nombre de la tabla para la que recuperar la definición. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TransactionId: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Custom string pattern #11.ID de transacción en el que se va a leer el contenido de la tabla.
-
QueryAsOfTime: marca temporal.El momento a partir del que se debe leer el contenido de la tabla. Si no se establece, se utilizará el tiempo de confirmación de la transacción más reciente. No se puede especificar junto con
TransactionId.
Respuesta
-
Table: objeto Tabla.Objeto
Tableque define la tabla especificada.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionExceptionResourceNotReadyExceptionFederationSourceExceptionFederationSourceRetryableException
Acción GetTables (Python: get_tables)
Recupera las definiciones de algunas o de todas las tablas en una Database determinada.
Solicitud
-
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 del Catálogo de datos donde residen las tablas. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos del catálogo cuyas tablas se van a listar. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
Expression: cadena UTF-8 con un máximo de 2048 bytes de largo, que coincide con el Single-line string pattern.Un patrón de expresiones regulares. Si están presentes, solo se devuelven esas tablas cuyos nombres coinciden con el patrón.
-
NextToken: cadena UTF-8.Token de continuación, incluido si se trata de una llamada de continuidad.
-
MaxResults: número (entero) que no es inferior a 1 ni es superior a 100.El número máximo de tablas que se devuelven en una única respuesta.
-
TransactionId: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Custom string pattern #11.ID de transacción en el que se va a leer el contenido de la tabla.
-
QueryAsOfTime: marca temporal.El momento a partir del que se debe leer el contenido de la tabla. Si no se establece, se utilizará el tiempo de confirmación de la transacción más reciente. No se puede especificar junto con
TransactionId.
Respuesta
-
TableList: matriz de objetos Tabla.Una lista de los objetos
Tablesolicitados. -
NextToken: cadena UTF-8.Un token de continuación, presente si el segmento de lista actual no es el último.
Errores
EntityNotFoundExceptionInvalidInputExceptionOperationTimeoutExceptionInternalServiceExceptionGlueEncryptionExceptionFederationSourceExceptionFederationSourceRetryableException
Acción GetTableVersion (Python: get_table_version)
Recupera una versión especificada de una tabla.
Solicitud
-
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 del Catálogo de datos donde residen las tablas. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos del catálogo donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TableName: obligatorio: cadena UTF-8, 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 nombre de la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
VersionId: cadena UTF-8, 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 valor de ID de la versión de la tabla que se va a recuperar. Una
VersionIDes una representación de cadena de un número entero. Cada versión se incrementa en 1.
Respuesta
-
TableVersion: objeto TableVersion.La versión de la tabla solicitada.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
Acción GetTableVersions (Python: get_table_versions)
Recupera una lista de cadenas que identifican las versiones disponibles de una tabla especificada.
Solicitud
-
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 del Catálogo de datos donde residen las tablas. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos del catálogo donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TableName: obligatorio: cadena UTF-8, 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 nombre de la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
NextToken: cadena UTF-8.Token de continuación si no se trata de la primera llamada.
-
MaxResults: número (entero) que no es inferior a 1 ni es superior a 100.El número máximo de versiones de la tabla que se devuelven en una respuesta.
Respuesta
-
TableVersions: matriz de objetos TableVersion.Una lista de cadenas que identifican las versiones disponibles de la tabla especificada.
-
NextToken: cadena UTF-8.Token de continuación, si la lista de versiones disponibles no incluye la última.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
Acción DeleteTableVersion (Python: delete_table_version)
Elimina una versión especificada de una tabla.
Solicitud
-
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 del Catálogo de datos donde residen las tablas. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos del catálogo donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TableName: obligatorio: cadena UTF-8, 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 nombre de la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
VersionId: obligatorio: cadena UTF-8, 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 la versión de la tabla que se va a eliminar. Una
VersionIDes una representación de cadena de un número entero. Cada versión se incrementa en 1.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
Acción BatchDeleteTableVersion (Python: batch_delete_table_version)
Elimina un lote especificado de versiones de una tabla.
Solicitud
-
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 del Catálogo de datos donde residen las tablas. Si no se proporciona ninguno, se usará de forma predeterminada el ID de cuenta de AWS.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos del catálogo donde reside la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
TableName: obligatorio: cadena UTF-8, 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 nombre de la tabla. Para compatibilidad con Hive, este nombre está completamente en minúsculas.
-
VersionIds– Obligatorio: matriz de cadenas UTF-8, con 100 cadenas como máximo.Una lista de los ID de versiones que se van a eliminar. Una
VersionIdes una representación de cadena de un número entero. Cada versión se incrementa en 1.
Respuesta
-
Errors: matriz de objetos TableVersionError.Una lista de errores encontrados mientras se intentan eliminar las versiones de la tabla especificadas.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
Acción SearchTables (Python: search_tables)
Busca un conjunto de tablas basado en las propiedades de los metadatos de la tabla, así como en la base de datos principal. Puede realizar búsquedas en condiciones de texto o filtro.
Solo puede obtener tablas a las que tiene acceso en función de las políticas de seguridad definidas en Lake Formation. Necesita al menos un acceso de solo lectura a la tabla para que se devuelva. Si no tiene acceso a todas las columnas de la tabla, estas columnas no se buscarán cuando le devuelva la lista de tablas. Si tiene acceso a las columnas, pero no a los datos de las columnas, esas columnas y los metadatos asociados para esas columnas se incluirán en la búsqueda.
Solicitud
-
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.Un identificador único, que consta de
account_id. -
NextToken: cadena UTF-8.Token de continuación, incluido si se trata de una llamada de continuidad.
-
Filters: matriz de objetos PropertyPredicate.Una lista de pares clave-valor y un comparador utilizado para filtrar los resultados de búsqueda. Devuelve todas las entidades que coinciden con el predicado.
El miembro
Comparatorde la estructuraPropertyPredicatese usa solo para campos de tiempo y se puede omitir para otros tipos de campos. Además, al comparar valores de cadena, comoKey=Name, se utiliza un algoritmo de coincidencia aproximada. El campoKey(por ejemplo, el valor del campoName) se divide en tokens con determinados caracteres de puntuación, por ejemplo, -, :, #, etc. Luego, cada token es una coincidencia exacta en comparación con el miembroValuedePropertyPredicate. Por ejemplo, paraKey=NameyValue=link, se devuelven las tablas denominadascustomer-linkyxx-link-yy, pero no se devuelvexxlinkyy. -
SearchText: cadena de valor, de 1024 bytes de largo como máximo.Una cadena utilizada para una búsqueda de texto.
Especificar un valor entre comillas filtra en base a una coincidencia exacta con el valor.
-
SortCriteria: matriz de objetos SortCriterion, con 1 estructura como máximo.Una lista de criterios para ordenar los resultados por nombre de campo, en orden ascendente o descendente.
-
MaxResults: número (entero) que no es inferior a 1 ni es superior a 1000.El número máximo de tablas que se devuelven en una única respuesta.
-
ResourceShareType: cadena UTF-8 (valores válidos:FOREIGN|ALL|FEDERATED).Le permite especificar que desea buscar en las tablas compartidas con su cuenta. Los valores permitidos son
FOREIGNoALL.-
Si se establece en
FOREIGN, buscará en las tablas compartidas con su cuenta. -
Si se establece en
ALL, buscará en las tablas compartidas con su cuenta, así como en las tablas de su cuenta local.
-
Respuesta
-
NextToken: cadena UTF-8.Un token de continuación, presente si el segmento de lista actual no es el último.
-
TableList: matriz de objetos Tabla.Una lista de los objetos
Tablesolicitados. La respuestaSearchTablesdevuelve solo las tablas a las que tiene acceso.
Errores
InternalServiceExceptionInvalidInputExceptionOperationTimeoutException
Acción GetPartitionIndexes (Python: get_partition_indexes)
Recupera los índices de partición asociados a una tabla.
Solicitud
-
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 del catálogo donde reside la tabla.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Especifica el nombre de una base de datos desde la que desea recuperar índices de particiones.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Especifica el nombre de una base de datos para la que desea recuperar índices de particiones.
-
NextToken: cadena UTF-8.Token de continuación, incluido si se trata de una llamada de continuidad.
Respuesta
-
PartitionIndexDescriptorList: matriz de objetos PartitionIndexDescriptor.Una lista de descriptores de índice.
-
NextToken: cadena UTF-8.Un token de continuación, presente si el segmento de lista actual no es el último.
Errores
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionEntityNotFoundExceptionConflictException
Acción CreatePartitionIndex (Python: create_partition_index)
Crea un índice de partición especificado en una tabla existente.
Solicitud
-
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 del catálogo donde reside la tabla.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Especifica el nombre de una base de datos en la que desea crear un índice de particiones.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Especifica el nombre de una tabla en la que desea crear un índice de particiones.
-
PartitionIndex: obligatorio: objeto PartitionIndex.Especifica una estructura de
PartitionIndexpara crear un índice de partición en una tabla existente.
Respuesta
Sin parámetros de respuesta.
Errores
AlreadyExistsExceptionInvalidInputExceptionEntityNotFoundExceptionResourceNumberLimitExceededExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
Acción DeletePartitionIndex (Python: delete_partition_index)
Elimina un índice de partición especificado de una tabla existente.
Solicitud
-
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 del catálogo donde reside la tabla.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Especifica el nombre de una base de datos desde la que desea eliminar un índice de particiones.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Especifica el nombre de una tabla desde la que desea eliminar un índice de particiones.
-
IndexName: obligatorio: cadena UTF-8, 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 nombre del índice de partición que se eliminará.
Respuesta
Sin parámetros de respuesta.
Errores
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionEntityNotFoundExceptionConflictExceptionGlueEncryptionException
Acción GetColumnStatisticsForTable (Python: get_column_statistics_for_table)
Recupera estadísticas de las columnas de las tablas.
El permiso de Identity and Access Management (IAM) necesario para esta operación es GetTable.
Solicitud
-
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 del Catálogo de datos donde residen las particiones en cuestión. Si no se proporciona ninguno, el ID de cuenta de AWS se usará de forma predeterminada.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos de catálogos donde residen las particiones.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre de la tabla de las particiones.
-
ColumnNames– Obligatorio: matriz de cadenas UTF-8, con 100 cadenas como máximo.Una lista de los nombres de las columnas.
Respuesta
-
ColumnStatisticsList: matriz de objetos ColumnStatistics.Lista de ColumnStatistics.
-
Errors: matriz de objetos ColumnError.Lista de ColumnStatistics que no se pudieron recuperar.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
Acción UpdateColumnStatisticsForTable (Python: update_column_statistics_for_table)
Crea o actualiza las estadísticas de las columnas de la tabla.
El permiso de Identity and Access Management (IAM) necesario para esta operación es UpdateTable.
Solicitud
-
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 del Catálogo de datos donde residen las particiones en cuestión. Si no se proporciona ninguno, el ID de cuenta de AWS se usará de forma predeterminada.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos de catálogos donde residen las particiones.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre de la tabla de las particiones.
-
ColumnStatisticsList– Obligatorio: matriz de objetos ColumnStatistics, con 25 estructuras como máximo.Una lista de las estadísticas de las columnas.
Respuesta
-
Errors: matriz de objetos ColumnStatisticsError.Lista de ColumnStatisticsErrors.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
Acción DeleteColumnStatisticsForTable (Python: delete_column_statistics_for_table)
Recupera estadísticas de las columnas de las tablas.
El permiso de Identity and Access Management (IAM) necesario para esta operación es DeleteTable.
Solicitud
-
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 del Catálogo de datos donde residen las particiones en cuestión. Si no se proporciona ninguno, el ID de cuenta de AWS se usará de forma predeterminada.
-
DatabaseName: obligatorio: cadena UTF-8, 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 nombre de la base de datos de catálogos donde residen las particiones.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre de la tabla de las particiones.
-
ColumnName: obligatorio: cadena UTF-8, 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 nombre de la columna.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
