# Perfil do IAM
<a name="odbc-v2-driver-iam-profile"></a>

É possível configurar um perfil nomeado para se conectar ao Amazon Athena usando o driver ODBC. Você pode usar um perfil nomeado com uma das seguintes fontes de credenciais:
+ `Ec2InstanceMetadata`: recupera as credenciais do Serviço de metadados de instância (IMDS) do Amazon EC2. Este caderno é executado em uma instância do Amazon EC2.
+ `EcsContainer`: recupera as credenciais do endpoint do Perfil de tarefa do Amazon ECS. Use isso ao executar em um contêiner do Amazon ECS.
+ `Environment`: recupera as credenciais de variáveis de ambiente (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`).

Defina o parâmetro `credential_source` em seu perfil de configuração da AWS com o valor apropriado para seu ambiente. Para usar um provedor de credenciais personalizado em um perfil nomeado, especifique um valor para o parâmetro `plugin_name` na configuração do perfil.

## Tipo de autenticação
<a name="odbc-v2-driver-iam-profile-authentication-type"></a>


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| AuthenticationType | Obrigatório | IAM Credentials | AuthenticationType=IAM Profile; | 

## AWSPerfil da
<a name="odbc-v2-driver-iam-profile-aws-profile"></a>

O nome do perfil a ser usado com a conexão ODBC. Para obter mais informações sobre perfis, consulte [Usar perfis nomeados](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-using-profiles) no *Guia do usuário da AWS Command Line Interface*.


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| Perfil da AWS | Obrigatório | none | AWSProfile=default; | 

## Perfil preferencial
<a name="odbc-v2-driver-iam-profile-preferred-role"></a>

O nome do recurso da Amazon (ARN) da função a ser assumida. Utiliza-se o parâmetro de perfil preferencial quando o provedor de credenciais personalizadas é especificado pelo parâmetro `plugin_name` na configuração do perfil. Para obter mais informações sobre perfis de ARN, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*. 


****  

| **Nome da string de conexão** | **Tipo de parâmetro** | **Valor padrão** | **Exemplo de string de conexão** | 
| --- | --- | --- | --- | 
| preferred\$1role | Opcional | none | preferred\$1role=arn:aws:IAM::123456789012:id/user1; | 

## Duração da sessão
<a name="odbc-v2-driver-iam-profile-session-duration"></a>

A duração, em segundos, da sessão do perfil. Para obter mais informações sobre duração da sessão, consulte [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) na *AWS Security Token Service API Reference*. Utiliza-se o parâmetro de duração da sessão quando o provedor de credenciais personalizadas é especificado pelo parâmetro `plugin_name` na configuração do perfil.


****  

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

## Nome do plug-in
<a name="odbc-v2-driver-iam-profile-plugin-name"></a>

Especifica o nome de um provedor de credenciais personalizadas utilizado em um perfil nomeado. Esse parâmetro pode assumir os mesmos valores do campo **Tipo de autenticação** do administrador de fonte de dados ODBC, mas é usado somente pela configuração do `AWSProfile`.


****  

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