Opciones avanzadas

Tamaño de recuperación

El número máximo de resultados (filas) que se devuelven en esta solicitud. Para obtener información sobre el parámetro, consulte GetQuery MaxResults. Para la API de transmisión, el valor máximo es 10 000 000.

Buscador de resultados

El buscador de resultados predeterminado descarga los resultados de las consultas directamente desde Amazon S3 sin pasar por las operaciones de la API de Athena. Cuando detecta situaciones en las que no es posible la descarga directa de S3, automáticamente recurre a utilizar la operación de la API de GetQueryResultsStream. Por ejemplo, esto ocurre cuando los resultados de las consultas se cifran con la opción CSE_KMS.

Se recomienda usar el buscador auto en la mayoría de las situaciones. Sin embargo, si sus políticas de IAM o sus políticas de bucket de S3 utilizan la condición s3:CalledVia para limitar el acceso a las solicitudes de objetos de S3 desde Athena, el buscador automático primero intenta descargar los resultados de S3 y, a continuación, recurre a utilizar el GetQueryResultsStream. En esta situación, se podría configurar el ResultFetcher en GetQueryResultsStream para evitar una llamada a la API adicional.

Habilitar la reutilización de resultados

Especifica si los resultados de la consulta anterior se pueden reutilizar al ejecutar la consulta. Para obtener información sobre el parámetro, consulte ResultReuseByAgeConfiguration.

Antigüedad máxima de reutilización de resultados

Especifica, en minutos, la antigüedad máxima de un resultado de consulta anterior que Athena debe tener en cuenta para su reutilización. Para obtener información sobre el parámetro, consulte ResultReuseByAgeConfiguration.

Utilizar varios hilos de S3

Recupera datos de Amazon S3 mediante varios hilos. Cuando esta opción está habilitada, el archivo de resultados almacenado en el bucket de Amazon S3 se recupera en paralelo mediante varios hilos.

Habilite esta opción solo si tiene un buen ancho de banda de la red. Por ejemplo, en nuestras mediciones en una instancia c5.2xlarge de EC2, un cliente S3 de un solo hilo alcanzó 1 Gbps, mientras que los clientes S3 de hilos múltiples alcanzaron un rendimiento de red de 4 Gbps.

Utilizar un único catálogo y esquema

De forma predeterminada, el controlador ODBC consulta a Athena para obtener la lista de catálogos y esquemas disponibles. Esta opción obliga al controlador a utilizar el catálogo y el esquema especificados en el cuadro de diálogo de configuración del administrador de orígenes de datos ODBC o en los parámetros de conexión.

Utilice una consulta para enumerar tablas

Para los tipos de catálogo LAMBDA, permite que el controlador ODBC envíe una consulta SHOW TABLES para obtener una lista de las tablas disponibles. Esta configuración es la predeterminada. Si este parámetro se establece en 0, el controlador ODBC utiliza la API ListTableMetadata de Athena para obtener una lista de las tablas disponibles. Tenga en cuenta que, en el caso de los tipos de catálogos LAMBDA, el uso de ListTableMetadata conduce a una regresión del rendimiento.

Utilice WCHAR para los tipos de cadenas

De forma predeterminada, el controlador ODBC utiliza SQL_CHAR y SQL_VARCHAR para Athena, los tipos de datos de cadena char, varchar, string, array, map<>, struct<> y row. Si se establece este parámetro a 1, se fuerza al controlador a utilizar SQL_WCHAR y SQL_WVARCHAR para los tipos de datos de cadena. Los tipos de caracteres y variables anchos se utilizan para garantizar que los caracteres de diferentes idiomas se puedan almacenar y recuperar correctamente.

Consultar catálogos externos

Especifica si el controlador necesita consultar catálogos externos desde Athena. Para obtener más información, consulte Migración al controlador ODBC 2.x.

Verificar SSL

Controla si se deben verificar los certificados SSL cuando se usa el SDK de AWS. Este valor se transfiere al parámetro ClientConfiguration.verifySSL. Para obtener más información, consulte Configuración de cliente de AWS en la Guía para desarrolladores de AWS SDK para C++.

Tamaño del bloque de resultados de S3

Especifica, en bytes, el tamaño del bloque que se va a descargar para una sola solicitud de API GetObject de Amazon S3. El valor predeterminado es 67108864 (64 MB). Los valores mínimo y máximo permitidos son 10485760 (10 MB) y 2146435072 (aproximadamente 2 GB).

Longitud de columna de cadena

Especifica la longitud de las columnas con el tipo de datos string. Como Athena usa el tipo de datos de cadena Apache Hive, que no tiene una precisión definida, la longitud predeterminada que informa Athena es 2147483647 (INT_MAX). Como las herramientas de inteligencia empresarial suelen preasignar memoria a las columnas, esto puede provocar un consumo elevado de memoria. Para evitarlo, el controlador ODBC de Athena limita la precisión notificada para las columnas del tipo de datos string y expone el parámetro de conexión StringColumnLength para que se pueda cambiar el valor predeterminado.

Longitud de columna de tipo complejo

Especifica la longitud de las columnas con tipos de datos complejos, como map, struct, y array. Al igual que StringColumnLength, Athena informa de una precisión de 0 para las columnas con tipos de datos complejos. El controlador ODBC de Athena establece la precisión predeterminada para las columnas con tipos de datos complejos y expone el parámetro de conexión ComplexTypeColumnLength para que se pueda cambiar el valor predeterminado.

Certificado de CA de confianza

Indica al cliente HTTP dónde encontrar el almacén de confianza de certificados SSL. Este valor se transfiere al parámetro ClientConfiguration.caFile. Para obtener más información, consulte Configuración de cliente de AWS en la Guía para desarrolladores de AWS SDK para C++.

Periodo mínimo de sondeo

Especifica el valor mínimo en milisegundos que debe esperarse antes de sondear Athena para determinar el estado de ejecución de la consulta.

Periodo máximo de sondeo

Especifica el valor máximo en milisegundos que se debe esperar antes de sondear Athena para determinar el estado de ejecución de la consulta.

Multiplicador de sondeo

Especifica el factor para aumentar el periodo de sondeo. De forma predeterminada, el sondeo comienza con el valor del periodo mínimo de sondeo y se duplica con cada sondeo hasta alcanzar el valor del periodo máximo de sondeo.

Duración máxima del sondeo

Especifica el valor máximo en milisegundos del tiempo durante el cual un controlador puede sondear Athena para determinar el estado de ejecución de la consulta.

Tiempo de espera de la conexión

La cantidad de tiempo (en milisegundos) que la conexión HTTP espera a que se establezca una conexión. Este valor se establece para el cliente de Athena ClientConfiguration.connectTimeoutMs. Si no se especifica, se usa el valor predeterminado de curl. Para obtener más información sobre los parámetros de conexión, consulte Configuración de clientes en la Guía para desarrolladores de AWS SDK para Java.

Tiempo de espera de la solicitud

Especifica el tiempo de espera de lectura del socket para los clientes HTTP. Este valor se establece para el parámetro ClientConfiguration.requestTimeoutMs del cliente de Athena. Para obtener información sobre el parámetro, consulte Configuración de clientes en la Guía para desarrolladores de AWS SDK para Java.