Consulta de datos: configuraciones de tablas y consultas SQL - Exportaciones de datos de AWS
Consultas SQLConfiguraciones de tabla

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Consulta de datos: configuraciones de tablas y consultas SQL

Exportación de datos permite escribir consultas SQL (selecciones de columnas, filtrado de filas, alias de columnas) que se ejecutan en las tablas proporcionadas (por ejemplo, CUR 2.0). Cada tabla también puede tener configuraciones de tabla que alteren los datos contenidos en la tabla. Por ejemplo, con CUR 2.0, puede especificar una configuración para elegir un grado de detalle de tiempo por hora, día o mes, o una configuración para agregar datos de costo y uso con un grado de detalle en el nivel de recursos.

Para que una consulta de datos de exportación esté completamente definida, debe especificar los dos atributos siguientes:

  • Consulta SQL: la instrucción SQL se ejecuta en una tabla y determina qué datos devuelve la exportación.

  • Configuraciones de tabla: las opciones de configuración de la tabla cambian los datos que contiene la tabla antes de que se ejecute en ella la consulta SQL.

En la página Exportación de datos de la consola, puede utilizar el flujo de trabajo que crea las configuraciones de tabla e instrucciones SQL en función de sus selecciones. En el SDK o la CLI de Exportación de datos, puede escribir sus propias configuraciones de tabla e instrucciones SQL.

Las instrucciones SQL de Exportación de datos (QueryStatement) utilizan la siguiente sintaxis:

SELECT <column_name_a>, <column_name_b>.<attribute_name> AS <new_name>, ... 
FROM <TABLE_NAME>
[ WHERE <column_name> OPERATOR <value> AND|OR ... ]
[ LIMIT number ]

Las configuraciones de tabla de Exportación de datos (TableConfigurations) utilizan la siguiente sintaxis:

{"<TABLE_NAME>":
    {"<CONFIGURATION_NAME_A>": "<value>",
     "<CONFIGURATION_NAME_B>": "<value>", 
     ...}
            }

Consultas SQL

La consulta SQL se ejecuta en una tabla y determina qué datos devuelve la exportación. La instrucción SQL se puede modificar después de crear una exportación, pero la tabla seleccionada no se puede cambiar.

Las sentencias SQL (en el QueryStatement campo) pueden tener un máximo de 36 000 caracteres.

Las palabras clave posibles en una consulta SQL de Exportación de datos son las siguientes.

nota

Las palabras clave no distinguen entre mayúsculas y minúsculas. Los nombres de columna y los nombres de tabla distinguen entre mayúsculas y minúsculas.

SELECT

Obligatorio.

Especifica qué columnas se van a seleccionar de la tabla. Solo puede haber una instrucción SELECT por consulta.

Utilice el operador de punto . para especificar la selección de un atributo de una columna MAP o STRUCT como columna independiente. De forma predeterminada, el nombre de la columna resultante en la salida de SQL es el nombre del atributo.

Por ejemplo, puede seleccionar atributos de la columna MAP del producto.

SELECT product.from_location FROM COST_AND_USAGE_REPORT

Esto seleccionará el atributo from_location de la columna product y creará una nueva columna con los datos del atributo. De forma predeterminada, en la salida, el nombre de la columna será from_location. Sin embargo, se puede cambiar el nombre a AS.

Para obtener más información sobre las columnas MAP y STRUCT disponibles en cada tabla, y sobre los atributos que tienen estas columnas, consulte Data Exports table dictionary.

AS

Opcional.

Permite cambiar el nombre de la columna seleccionada. El nuevo nombre de columna no puede tener espacios ni caracteres que no sean alfanuméricos (a-z, A-Z y 0-9) o guiones bajos (_). No puede usar comillas al definir el alias de la columna para poder usar otros caracteres.

Los alias pueden resultar útiles al seleccionar un atributo de una columna MAP o STRUCT para cambiar el nombre de la columna resultante a fin de que coincida con el esquema del CUR. Por ejemplo, para que coincida con la forma en que el CUR muestra la columna product_from_location, escriba la siguiente consulta en Exportación de datos con la tabla CUR 2.0.

SELECT product.from_location AS product_from_location FROM COST_AND_USAGE_REPORT

Esto crea una exportación con una columna llamada product_from_location.

FROM

Obligatorio.

Especifica la tabla que se va a consultar. Solo puede haber una instrucción FROM por consulta.

WHERE

Opcional.

Filtra las filas para que solo coincidan con la cláusula especificada.

La cláusula WHERE (DONDE) es compatible con los siguientes operadores:

  • = El valor debe coincidir con la cadena o el número.

  • != and <> El valor no debe coincidir con la cadena o el número especificados.

  • <, <=, >, y >= El valor debe ser menor que el número, menor o igual que el número, mayor que el número o mayor o igual que el número.

  • AND (Y) Ambas condiciones especificadas deben ser verdaderas para que coincidan. Puede usar varias palabras clave AND (Y) para especificar dos o más condiciones.

  • OR Cualquiera de las condiciones que se especifiquen debe ser verdadera para coincidir. Puede usar varias palabras clave OR para especificar dos o más condiciones.

  • NOT La condición especificada no debe ser verdadera para coincidir.

  • IN Cualquiera de los valores especificados entre paréntesis después de la palabra clave debe ser verdadero para que coincida.

  • Los paréntesis se pueden usar para construir cláusulas WHERE multicondicionales

nota

Al expresar cadenas como el valor que sigue a un operador, utilice comillas simples ' en lugar de comillas dobles. No es necesario evitar las comillas simples. Por ejemplo, puede escribir la siguiente instrucción WHERE:

WHERE line_item_type = 'Discount' OR line_item_type = 'Usage'

LIMIT

Opcional.

Limita el número de filas devueltas por la consulta al valor que usted especifique.

Configuraciones de tabla

Las configuraciones de tabla son propiedades controladas por el usuario que un usuario puede configurar para cambiar los datos o el esquema de una tabla antes de consultarla en Exportación de datos. Las configuraciones de la tabla se guardan como una sentencia JSON y se especifican mediante la entrada del usuario en el AWS SDK/CLI o mediante las selecciones del usuario en la consola.

Por ejemplo, CUR 2.0 tiene configuraciones de tabla para cambiar el nivel de detalle de los datos (por hora, día o mes), para determinar si se incluyen datos granulares en el nivel de recursos y para indicar si se incluyen datos de asignación de costos divididos. No todas las tablas tienen configuraciones. Para obtener más información sobre las configuraciones disponibles para cada tabla, consulte Data Exports table dictionary.

Cada parámetro de configuración de la tabla tiene un valor predeterminado que se asume si el usuario no especifica una configuración de tabla. Las configuraciones de las tablas no pueden modificarse después de crear una exportación.