

# Parámetros de conexión ODBC 2.x principales
<a name="odbc-v2-driver-main-connection-parameters"></a>

En las siguientes secciones se describe cada uno de los parámetros de conexión principales.

## Nombre de origen de datos
<a name="odbc-v2-driver-main-connection-parameters-data-source-name"></a>

Especifica el nombre del origen de datos.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| DSN | Opcional para los tipos de conexión sin DSN | none | DSN=AmazonAthenaOdbcUsWest1; | 

## Descripción
<a name="odbc-v2-driver-main-connection-parameters-description"></a>

Contiene una descripción del origen de datos.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| Descripción | Opcional | none | Description=Connection to Amazon Athena us-west-1; | 

## Catálogo
<a name="odbc-v2-driver-main-connection-parameters-catalog"></a>

Especifica el nombre del catálogo de datos. Para obtener más información sobre los catálogos, consulte [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html) en la Referencia de la API de Amazon Athena.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| Catálogo | Opcional | AwsDataCatalog | Catalog=AwsDataCatalog; | 

## Región
<a name="odbc-v2-driver-region"></a>

Especifica el Región de AWS. Para obtener información sobre las Regiones de AWS, consulte [Regiones y zonas de disponibilidad](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/).


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| AwsRegion | Obligatorio | none | AwsRegion=us-west-1; | 

## Database
<a name="odbc-v2-driver-database"></a>

Especifica el nombre de la base de datos. Para obtener más información sobre las bases de datos, consulte [Bases de datos](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html) en la *Referencia de la API de Amazon Athena*.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| Esquema | Opcional | default | Schema=default; | 

## Grupo de trabajo
<a name="odbc-v2-driver-workgroup"></a>

Especifica el nombre del grupo de trabajo. Para obtener más información sobre los grupos de trabajo, consulte [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html) en la *Referencia de la API de Amazon Athena*.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| Grupo de trabajo | Opcional | primary | Workgroup=primary; | 

## Ubicación de salida
<a name="odbc-v2-driver-output-location"></a>

Especifica la ubicación en Amazon S3 en la que se almacenan los resultados de las consultas. Para obtener más información sobre la ubicación de salida, consulte [ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html) en la *Referencia de la API de Amazon Athena*.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| S3OutputLocation | Obligatorio | none | S3OutputLocation=s3://amzn-s3-demo-bucket/; | 

## Opciones de cifrado
<a name="odbc-v2-driver-encryption-options"></a>

**Nombre del parámetro de diálogo**: opciones de cifrado

Especifica la opción de cifrado. Para obtener más información sobre las opciones de cifrado, consulte [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) en la *Referencia de la API de Amazon Athena*.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Valores posibles** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | --- | 
| S3OutputEncOption | Opcional | none | NOT\$1SET, SSE\$1S3, SSE\$1KMS, CSE\$1KMS | S3OutputEncOption=SSE\$1S3; | 

## Clave KMS
<a name="odbc-v2-driver-kms-key"></a>

Especifica una clave de KMS para el cifrado. Para obtener más información sobre la configuración de cifrado de las claves de KMS, consulte [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) en la *Referencia de la API de Amazon Athena*.


****  

| **Nombre de la cadena de conexión** | **Tipo de parámetro** | **Predeterminado** | **Ejemplo de la cadena de conexión** | 
| --- | --- | --- | --- | 
| S3OutputEncKMSKey | Opcional | none | S3OutputEncKMSKey=your\$1key; | 

## Prueba de conexión
<a name="odbc-v2-driver-connection-test"></a>

El administrador de orígenes de datos ODBC ofrece la opción **Prueba** que puede utilizar para probar la conexión de ODBC 2.x a Amazon Athena. Para ver los pasos, consulte [Configuración del nombre de origen de datos en Windows](odbc-v2-driver-getting-started-windows.md#odbc-v2-driver-configuring-dsn-on-windows). Al probar una conexión, el controlador ODBC llama a la acción de la API de Athena [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html). La llamada utiliza el tipo de autenticación y el proveedor de credenciales correspondiente que especificó para recuperar las credenciales. La prueba de conexión es gratuita cuando se utiliza el controlador ODBC 2.x. La prueba no genera resultados de consultas en el bucket de Amazon S3.