API de tabla - AWS Glue

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 de partitionKeys 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 de partitionKeys 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 o False 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 o False 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.

  • SortOrderObligatorio: 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.

  • TypeObligatorio: 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.

  • KeysObligatorio: 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.

  • IndexStatusObligatorio: 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
  • MetadataOperationObligatorio: 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 durante CREATE VIEW DDL. Este SQL no se usa durante una consulta en una vista (en su lugar, se usa ViewExpandedText). ViewOriginalText se usa en casos como SHOW 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 en ViewExpandedText. 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 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. Si skipArchive 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.

  • TablesToDeleteObligatorio: 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 el NAME.

    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.

  • VersionIdsObligatorio: 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 estructura PropertyPredicate se usa solo para campos de tiempo y se puede omitir para otros tipos de campos. Además, al comparar valores de cadena, como Key=Name, se utiliza un algoritmo de coincidencia aproximada. El campo Key (por ejemplo, el valor del campo Name) 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 miembro Value de PropertyPredicate. Por ejemplo, para Key=Name y Value=link, se devuelven las tablas denominadas customer-link y xx-link-yy, pero no se devuelve xxlinkyy.

  • 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 o ALL.

    • 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 respuesta SearchTables 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.

  • ColumnNamesObligatorio: 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.

  • ColumnStatisticsListObligatorio: matriz de objetos ColumnStatistics, con 25 estructuras como máximo.

    Una lista de las estadísticas de las columnas.

Respuesta
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