Principais parâmetros de conexão do ODBC 2.x
As seções a seguir descrevem cada um dos principais parâmetros de conexão.
Nome da fonte de dados
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
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
Especifica o nome do catálogo de dados. Para obter mais informações, consulte DataCatalog 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
Especifica o Região da AWS. Para obter informações sobre Regiões da AWS, consulte Regiões e zonas de disponibilidade
| 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
Especifica o nome do banco de dados. Para obter mais informações, consulte Database 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; |
WorkGroup
Especifica o nome do grupo de trabalho. Para obter mais informações sobre grupos de trabalho, consulte WorkGroup na Amazon Athena API Reference.
| Nome da string de conexão | Tipo de parâmetro | Valor padrão | Exemplo de string de conexão |
|---|---|---|---|
| WorkGroup | Opcional | primary |
Workgroup=primary; |
Local de saída
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 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://DOC-EXAMPLE-BUCKET/; |
Opções de criptografia
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 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_SET, SSE_S3, SSE_KMS,
CSE_KMS |
S3OutputEncOption=SSE_S3; |
Chave KMS
Especifica uma chave do KMS para criptografia. Para obter mais informações sobre configuração de criptografia para chaves do KMS, consulte EncryptionConfiguration 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_key; |
Teste de conexão
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. Quando você testa uma conexão, o driver ODBC chama a ação da API GetWorkGroup 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.
