As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Analise dados DataZone assinados pela Amazon com aplicativos de análise externos via conexão JDBC
A Amazon DataZone permite que os consumidores de dados localizem e assinem facilmente dados de várias fontes em um único projeto e analisem esses dados usando o Amazon Athena, o Amazon Redshift Query Editor e a Amazon. SageMaker
A Amazon DataZone também oferece suporte à autenticação por meio do driver Athena JDBC, que permite que os usuários consultem seus DataZone dados inscritos na Amazon usando ferramentas externas populares de SQL e análise, como SQL Workbench, Tableau, Domino DBeaver, Power BI e muitas outras. Os usuários podem se autenticar usando suas credenciais corporativas por meio de SSO ou IAM e começar a analisar seus dados inscritos em seus projetos da Amazon. DataZone
O suporte DataZone da Amazon ao driver Athena JDBC oferece os seguintes benefícios:
+ Maior escolha de ferramentas para consulta e visualização — os consumidores de dados podem se conectar à Amazon DataZone usando suas ferramentas preferidas a partir de uma ampla variedade de ferramentas de análise que oferecem suporte a uma conexão JDBC. Isso permite que eles continuem usando o software com o qual estão familiarizados sem a necessidade de aprender novas ferramentas para consumo de dados.
+ Acesso programático — uma conexão JDBC para acessar dados controlados por meio de servidores ou aplicativos personalizados permite que os consumidores de dados realizem operações de dados automatizadas e mais complexas.
Você pode usar sua URL do JDBC para conectar suas ferramentas de análise externas aos dados DataZone assinados pela Amazon. Para obter seu URL do JDBC, execute o seguinte procedimento:
**Importante**
Na versão atual, a Amazon DataZone oferece suporte à autenticação usando o driver Amazon Athena JDBC. Para concluir esse procedimento, verifique se você baixou e instalou o [driver Athena JDBC](https://docs.aws.amazon.com/athena/latest/ug/jdbc-v3-driver.html) mais recente para o aplicativo de análise de sua escolha.
1. Navegue até o URL do portal de DataZone dados da Amazon e faça login usando o single sign-on (SSO) ou suas credenciais. AWS Se você for DataZone administrador da Amazon, poderá navegar até o DataZone console da Amazon em [https://console.aws.amazon.com/datazone](https://console.aws.amazon.com/datazone) e fazer login com o Conta da AWS local onde o domínio foi criado e, em seguida, escolher **Open** data portal.
1. No portal de DataZone dados da Amazon, escolha **Procurar lista de projetos** e, em seguida, encontre e escolha o projeto em que você tem os dados que deseja analisar.
1. No painel lateral direito da página inicial do projeto, escolha **Connect with JDBC**.
1. Na janela pop-up de **parâmetros do JDBC**, escolha o método de autenticação (credenciais de SSO ou credenciais do IAM) e, em seguida, copie a string ou os parâmetros individuais do URL do JDBC. Em seguida, você pode usá-lo para se conectar ao seu aplicativo de análise externo.
Ao conectar seu aplicativo de análise externo à Amazon DataZone usando sua consulta ou parâmetros do JBDC, você invoca a API. `RedeemAccessToken` A `RedeemAccessToken` API troca um token de acesso ao Identity Center pelas `AmazonDataZoneDomainExecutionRole` credenciais, que são usadas para chamar a `GetEnvironmentCredentials` API.
[Para obter mais informações sobre o mecanismo de autenticação que usa credenciais do IAM para se conectar aos dados DataZone administrados pela Amazon no Athena, consulte Provedor de credenciais do IAM. DataZone ](https://docs.aws.amazon.com/athena/latest/ug/jdbc-v3-driver-datazone-iamcp.html) [Para obter mais informações sobre o mecanismo de autenticação que permite a conexão com dados DataZone administrados pela Amazon no Athena usando o IAM Identity Center, consulte DataZone Idc Credentials Provider.](https://docs.aws.amazon.com/athena/latest/ug/jdbc-v3-driver-datazone-idc.html)
## RedeemAccessToken Referência da API
**Sintaxe da solicitação**
```
POST /sso/redeem-token HTTP/1.1
Content-type: application/json
{
"domainId": "string",
"accessToken": "string"
}
```
**Parâmetros de solicitação**
A solicitação usa os seguintes parâmetros:
**DomainId**
O ID do DataZone domínio da Amazon.
padrão: ^dzd[-\$1][a-zA-Z0-9\$1-]\$11,36\$1\$1
Obrigatório: sim
**AccessToken**
O token de acesso ao Identity Center.
Tipo: string
Obrigatório: sim
**Sintaxe da resposta**
```
HTTP/1.1 200
Content-type: application/json
{
"credentials": AwsCredentials
}
```
**Elementos de resposta**
**credenciais**
As `AmazonDataZoneDomainExecutionRole` credenciais usadas para chamar a `GetEnvironmentCredentials` API.
Tipo: matriz de objetos `AwsCredentials` Esse tipo de dado inclui as seguintes propriedades:
+ accessKeyId: AccessKeyId
+ secretAccessKey: SecretAccessKey
+ SessionToken: SessionToken
+ expiração: timestamp
**AccessToken**
O token de acesso ao Identity Center.
Tipo: string
Obrigatório: sim
**Erros**
**AccessDeniedException**
Você não tem acesso suficiente para executar esta ação.
Código de status HTTP: 403
**ResourceNotFoundException**
Não foi possível encontrar o recurso especificado.
Código de status HTTP: 404
**ValidationException**
A entrada não atende às restrições especificadas pelo serviço da AWS .
Código de status HTTP: 400
**InternalServerException**
A solicitação falhou por causa de um erro, uma exceção ou uma falha desconhecida.
Código de status HTTP: 500