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
: un 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 departitionKeys
en 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
: un objeto TableIdentifier.Estructura
TableIdentifier
que 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
: un objeto FederatedTable.Una estructura
FederatedTable
que hace referencia a una entidad externa aAWS Glue Data Catalog. -
ViewDefinition
: un objeto ViewDefinition.Estructura que contiene toda la información que define la vista, incluidos el dialecto o los dialectos de la vista, y la consulta.
-
IsMultiDialectView
: booleano.Especifica si la vista admite los dialectos SQL de uno o varios motores de consulta diferentes y, por lo tanto, si esos motores pueden leerla.
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
: un 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 departitionKeys
en 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
: un objeto TableIdentifier.Estructura
TableIdentifier
que describe una tabla de destino para la vinculación de recursos. -
ViewDefinition
: un objeto ViewDefinitionInput.Estructura que contiene toda la información que define la vista, incluidos el dialecto o los dialectos de la vista, y la consulta.
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
Columns
de 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),TextInputFormat
o 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),IgnoreKeyTextOutputFormat
o formato personalizado. -
Compressed
: booleano.True
si los datos de la tabla están comprimidos oFalse
si no. -
NumberOfBuckets
: número (entero).Debe especificarse si la tabla contiene alguna columna de dimensión.
-
SerdeInfo
: un 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
: un objeto SkewedInfo.La información sobre los valores que aparecen con frecuencia en una columna (valores sesgados).
-
StoredAsSubDirectories
: booleano.True
si los datos de la tabla se almacenan en subdirectorios oFalse
si no. -
SchemaReference
: un 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
: un objeto SchemaId.Estructura que contiene campos de identidad de esquema. Este o el
SchemaVersionId
tiene 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 #17.El ID único asignado a una versión del esquema. Este o el
SchemaId
tiene 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
: un 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
VersionId
es 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
: un 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
VersionID
es una representación de cadena de un número entero. Cada versión se incrementa en 1. -
ErrorDetail
: un 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
: un objeto IcebergInput.Especifica una estructura
IcebergInput
que define una tabla de metadatos de Apache Iceberg.
Estructura ViewDefinition
Estructura que contiene detalles para las representaciones.
Campos
-
IsProtected
: booleano.Puede establecer este indicador como verdadero para indicar al motor que no inserte las operaciones proporcionadas por el usuario en el plan lógico de la vista durante la planificación de las consultas. Sin embargo, establecer este indicador no garantiza que el motor cumpla con las normas. Consulte la documentación del motor para comprender las garantías que se ofrecen si las hubiera.
-
Definer
: 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.El definidor de una vista en SQL.
-
SubObjects
: matriz de cadenas UTF-8, con 10 cadenas como máximo.Una lista de los nombres de recursos de Amazon (ARN) de la tabla.
-
Representations
: matriz de objetos ViewRepresentation, con una estructura como mínimo y 1000 estructuras como máximo.Una lista de representaciones.
Estructura ViewDefinitionInput
Estructura que contiene detalles para crear o actualizar una vista de AWS Glue.
Campos
-
IsProtected
: booleano.Puede establecer este indicador como verdadero para indicar al motor que no inserte las operaciones proporcionadas por el usuario en el plan lógico de la vista durante la planificación de las consultas. Sin embargo, establecer este indicador no garantiza que el motor cumpla con las normas. Consulte la documentación del motor para comprender las garantías que se ofrecen si las hubiera.
-
Definer
: 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.El definidor de una vista en SQL.
-
Representations
: Una matriz de objetos ViewRepresentationInput, con 1 estructura como mínimo y 10 como máximo.Lista de estructuras que contiene el dialecto de la vista y la consulta que define la vista.
-
SubObjects
: matriz de cadenas UTF-8, con 10 cadenas como máximo.Una lista de los ARN de la tabla base que componen la vista.
Estructura ViewRepresentation
Estructura que contiene el dialecto de la vista y la consulta que define la vista.
Campos
-
Dialect
: cadena UTF-8 (valores válidos:REDSHIFT
|ATHENA
|SPARK
).El dialecto del motor de consultas.
-
DialectVersion
: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo.La versión del dialecto del motor de consultas. Por ejemplo, 3.0.0.
-
ViewOriginalText
: cadena UTF-8 de 409600 bytes de largo como máximo.La consulta
SELECT
proporcionada por el cliente duranteCREATE VIEW DDL
. Este SQL no se usa durante una consulta en una vista (en su lugar, se usaViewExpandedText
).ViewOriginalText
se usa en casos comoSHOW CREATE VIEW
, en los que los usuarios desean ver el comando DDL original que creó la vista. -
ViewExpandedText
: cadena UTF-8 de 409600 bytes de largo como máximo.El SQL expandido para la vista. Los motores utilizan este SQL para procesar una consulta en una vista. Es posible que los motores hagan operaciones durante la creación de la vista para transformar
ViewOriginalText
enViewExpandedText
. Por ejemplo:-
Identificadores totalmente cualificados:
SELECT * from table1 -> SELECT * from db1.table1
-
-
ValidationConnection
: 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 conexión que se usará para validar la representación específica de la vista.
-
IsStale
: booleano.Los dialectos marcados como obsoletos ya no son válidos y deben actualizarse para poder consultarlos en sus respectivos motores de consulta.
Estructura ViewRepresentationInput
Estructura que contiene detalles de una representación para actualizar o crear una vista de Lake Formation.
Campos
-
Dialect
: cadena UTF-8 (valores válidos:REDSHIFT
|ATHENA
|SPARK
).Parámetro que especifica el tipo de motor de una representación específica.
-
DialectVersion
: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo.Un parámetro que especifica la versión del motor de una representación específica.
-
ViewOriginalText
: cadena UTF-8 de 409600 bytes de largo como máximo.Una cadena que representa la consulta SQL original que describe la vista.
-
ValidationConnection
: 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 conexión que se usará para validar la representación específica de la vista.
-
ViewExpandedText
: cadena UTF-8 de 409600 bytes de largo como máximo.Cadena que representa la consulta SQL que describe la vista con los ARN de recursos ampliados.
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
TableInput
que 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 #16.El ID de la transacción.
-
OpenTableFormatInput
: un objeto OpenTableFormatInput.Especifica una estructura
OpenTableFormatInput
al crear una tabla de formato abierto.
Respuesta
Sin parámetros de respuesta.
Errores
AlreadyExistsException
InvalidInputException
EntityNotFoundException
ResourceNumberLimitExceededException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
ConcurrentModificationException
ResourceNotReadyException
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
TableInput
actualizado para definir la tabla de metadatos en el catálogo. -
SkipArchive
: booleano.De forma predeterminada,
UpdateTable
crea siempre una versión archivada de la tabla antes de actualizarla. SiskipArchive
se establece en true, sin embargo,UpdateTable
no 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 #16.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.
-
ViewUpdateAction
: cadena UTF-8 (valores válidos:ADD
|REPLACE
|ADD_OR_REPLACE
|DROP
).La operación que se llevará a cabo al actualizar la vista.
-
Force
: booleano.Un indicador que se puede establecer como verdadero para ignorar los requisitos de coincidencia entre el descriptor de almacenamiento y el subobjeto.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
ConcurrentModificationException
ResourceNumberLimitExceededException
GlueEncryptionException
ResourceNotReadyException
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 #16.ID de transacción en el que se va a eliminar el contenido de la tabla.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
ConcurrentModificationException
ResourceNotReadyException
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 #16.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
InvalidInputException
EntityNotFoundException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
ResourceNotReadyException
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 #16.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
. -
IncludeStatusDetails
: booleano.Especifica si se deben incluir los detalles de estado relacionados con una solicitud de creación o actualización de una vista del catálogo de datos AWS Glue.
Respuesta
-
Table
: un objeto Tabla.Objeto
Table
que define la tabla especificada.
Errores
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
ResourceNotReadyException
FederationSourceException
FederationSourceRetryableException
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 #16.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
. -
IncludeStatusDetails
: booleano.Especifica si se deben incluir los detalles de estado relacionados con una solicitud de creación o actualización de una vista del catálogo de datos AWS Glue.
-
AttributesToGet
: matriz de cadenas UTF-8.Especifica los campos de la tabla devueltos por la llamada
GetTables
. Este parámetro no acepta una lista vacía. La solicitud debe incluir elNAME
.Las siguientes son combinaciones de valores válidas:
-
NAME
: nombres de todas las tablas de la base de datos. -
NAME
,TABLE_TYPE
: nombres de todas las tablas y tipos de tablas.
-
Respuesta
-
TableList
: matriz de objetos Tabla.Una lista de los objetos
Table
solicitados. -
NextToken
: cadena UTF-8.Un token de continuación, presente si el segmento de lista actual no es el último.
Errores
EntityNotFoundException
InvalidInputException
OperationTimeoutException
InternalServiceException
GlueEncryptionException
FederationSourceException
FederationSourceRetryableException
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
VersionID
es una representación de cadena de un número entero. Cada versión se incrementa en 1.
Respuesta
-
TableVersion
: un objeto TableVersion.La versión de la tabla solicitada.
Errores
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
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
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
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
VersionID
es una representación de cadena de un número entero. Cada versión se incrementa en 1.
Respuesta
Sin parámetros de respuesta.
Errores
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
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
VersionId
es 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
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
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
Comparator
de la estructuraPropertyPredicate
se 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 miembroValue
dePropertyPredicate
. Por ejemplo, paraKey=Name
yValue=link
, se devuelven las tablas denominadascustomer-link
yxx-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
FOREIGN
oALL
.-
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.
-
-
IncludeStatusDetails
: booleano.Especifica si se deben incluir los detalles de estado relacionados con una solicitud de creación o actualización de una vista del catálogo de datos AWS Glue.
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
Table
solicitados. La respuestaSearchTables
devuelve solo las tablas a las que tiene acceso.
Errores
InternalServiceException
InvalidInputException
OperationTimeoutException
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
InternalServiceException
OperationTimeoutException
InvalidInputException
EntityNotFoundException
ConflictException
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
PartitionIndex
para crear un índice de partición en una tabla existente.
Respuesta
Sin parámetros de respuesta.
Errores
AlreadyExistsException
InvalidInputException
EntityNotFoundException
ResourceNumberLimitExceededException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
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
InternalServiceException
OperationTimeoutException
InvalidInputException
EntityNotFoundException
ConflictException
GlueEncryptionException
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
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
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 ColumnaStatisticsError.Lista de ColumnStatisticsErrors.
Errores
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
GlueEncryptionException
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
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException
GlueEncryptionException