

# Principais parâmetros de conexão do ODBC 2.x
<a name="odbc-v2-driver-main-connection-parameters"></a>

As seções a seguir descrevem cada um dos principais parâmetros de conexão.

## Nome da fonte de dados
<a name="odbc-v2-driver-main-connection-parameters-data-source-name"></a>

Especifica o nome de sua fonte de dados.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| DSN | Opcional para tipos de conexão sem DSN | none | DSN=AmazonAthenaOdbcUsWest1; | 

## Descrição
<a name="odbc-v2-driver-main-connection-parameters-description"></a>

Contém a descrição de sua fonte de dados.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| Descrição | Opcional | none | Description=Connection to Amazon Athena us-west-1; | 

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

Especifica o nome do catálogo de dados. Para obter mais informações, consulte [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html) na Amazon Athena API Reference.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| Catálogo | Opcional | AwsDataCatalog | Catalog=AwsDataCatalog; | 

## Região
<a name="odbc-v2-driver-region"></a>

Especifica o Região da AWS. Para obter informações sobre Regiões da AWS, consulte [Regiões e zonas de disponibilidade](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/).


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| AwsRegion | Obrigatório | none | AwsRegion=us-west-1; | 

## Banco de dados
<a name="odbc-v2-driver-database"></a>

Especifica o nome do banco de dados. Para obter mais informações, consulte [Database](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html) na *Amazon Athena API Reference*.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| Schema | Opcional | default | Schema=default; | 

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

Especifica o nome do grupo de trabalho. Para obter mais informações sobre grupos de trabalho, consulte [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html) na *Amazon Athena API Reference*.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| Grupo de trabalho | Opcional | primary | Workgroup=primary; | 

## Local de saída
<a name="odbc-v2-driver-output-location"></a>

Especifica o local do Amazon S3 em que os resultados da consulta são armazenados. Para obter mais informações sobre o local de saída, consulte [ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html) na *Amazon Athena API Reference*.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| S3OutputLocation | Obrigatório | none | S3OutputLocation=s3://amzn-s3-demo-bucket/; | 

## Opções de criptografia
<a name="odbc-v2-driver-encryption-options"></a>

**Nome do parâmetro da caixa de diálogo**: opções de criptografia

Especifica a opção de criptografia. Para obter mais informações sobre as opções de criptografia, consulte [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) na *Amazon Athena API Reference*.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Possíveis valores** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | --- | 
| S3OutputEncOption | Opcional | none | NOT\$1SET, SSE\$1S3, SSE\$1KMS, CSE\$1KMS | S3OutputEncOption=SSE\$1S3; | 

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

Especifica uma chave do KMS para criptografia. Para obter mais informações sobre configuração de criptografia para chaves do KMS, consulte [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html) na *Amazon Athena API Reference*.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| S3OutputEncKMSKey | Opcional | none | S3OutputEncKMSKey=your\$1key; | 

## Teste de conexão
<a name="odbc-v2-driver-connection-test"></a>

O administrador de fonte de dados ODBC oferece a opção **Teste**, que você pode usar para testar sua conexão ODBC 2.x com o Amazon Athena. Para obter as etapas, consulte [Configurar um nome de fonte de dados no Windows](odbc-v2-driver-getting-started-windows.md#odbc-v2-driver-configuring-dsn-on-windows). Quando você testa uma conexão, o driver ODBC chama a ação da API [GetWorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetWorkGroup.html) do Athena. A chamada usa o tipo de autenticação e o provedor de credenciais correspondente que você especificou para recuperar credenciais. Não há cobrança pelo teste de conexão ao usar o driver ODBC 2.x. O teste não gera resultados de consulta no bucket do Amazon S3.