Nombres de tablas, bases de datos y columnas

Siga estos consejos para nombrar objetos de bases de datos en Athena.

Los nombres de bases de datos, tablas y columnas deben tener 255 caracteres o menos

Los nombres de bases de datos, tablas y columnas deben contar con 255 caracteres o menos. Si se supera este límite, se genera el error Value at 'name' failed to satisfy constraint: Member must have length less than or equal to 255 (El valor en “nombre” no satisface la restricción: el miembro debe tener una longitud menor o igual a 255).

Utilice minúsculas para los nombres de tablas y columnas de las tablas de Athena

Athena acepta mayúsculas y minúsculas en consultas DDL y DML, pero minúsculas en los nombres cuando ejecuta la consulta. Por este motivo, evite el uso de mayúsculas y minúsculas para nombres de tablas o columnas, y no confíe en el uso de mayúsculas y minúsculas solamente en Athena para distinguir dichos nombres. Por ejemplo, si utiliza una instrucción DDL para crear una columna denominada Castle, la columna creada irá en minúsculas en castle. Si, a continuación, especifica el nombre de columna en una consulta DML como Castle o CASTLE, Athena usará minúsculas en el nombre para que ejecute la consulta, pero mostrará el encabezado de columna utilizando el modo que eligió en la consulta.

Los nombres de base de datos, tablas y columnas deben tener 255 caracteres o menos.

Nombres que comienzan con un guion bajo

Al crear tablas, utilice acentos graves para entrecomillar los nombres de las tablas, vistas o columnas que empiecen por un guion bajo. Por ejemplo:

CREATE EXTERNAL TABLE IF NOT EXISTS `_myunderscoretable`(
  `_id` string, `_index` string)
LOCATION 's3://my-athena-data/'

Nombres de tabla, vista o columna que comienzan por números

Al ejecutar consultas SELECT, CTAS o VIEW, ponga comillas alrededor de identificadores como los nombres de tabla, vista o columna que comienzan por un dígito. Por ejemplo:

CREATE OR REPLACE VIEW "123view" AS
SELECT "123columnone", "123columntwo"
FROM "234table"

Nombres de columna y tipos complejos

Para los tipos complejos, solo están permitidos caracteres alfanuméricos, guion bajo (_) y período (.) en los nombres de las columnas. Para crear una tabla y mapeos para claves con caracteres restringidos, puede utilizar una instrucción DDL personalizada. Para obtener más información, consulte el artículo Create tables in Amazon Athena from nested JSON and mappings using JSONSerDe (Crear tablas en Amazon Athena a partir de JSON anidado y asignaciones por medio de JSONSerDe) en el blog de macrodatos de AWS.

Palabras reservadas

Ciertas palabras reservadas de Athena deben tener caracteres de escape. Para entrecomillar las palabras reservadas en instrucciones DDL, utilice acentos graves (`) como carácter de escape. Para entrecomillar palabras reservadas en instrucciones SQL SELECT y en consultas en vistas, utilice dobles comillas (") como carácter de escape.

Para obtener más información, consulte Palabras clave reservadas.

Véase también

Para ver la sintaxis de creación de bases de datos y tablas completa, consulte las siguientes páginas.

• CREATE DATABASE

• CREATE TABLE