Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Analizza i dati DataZone sottoscritti ad Amazon con applicazioni di analisi esterne tramite connessione JDBC
<a name="query-with-jdbc"></a>

Amazon DataZone consente ai consumatori di dati di individuare e abbonarsi facilmente ai dati provenienti da più fonti all'interno di un unico progetto e di analizzarli utilizzando Amazon Athena, Amazon Redshift Query Editor e Amazon. SageMaker

Amazon supporta DataZone anche l'autenticazione tramite il driver JDBC Athena che consente agli utenti di interrogare i DataZone dati Amazon sottoscritti utilizzando i più diffusi strumenti di analisi e SQL esterni, come SQL Workbench, Tableau, Domino DBeaver, Power BI e molti altri. Gli utenti possono autenticarsi utilizzando le proprie credenziali aziendali tramite SSO o IAM e iniziare ad analizzare i dati sottoscritti all'interno dei progetti Amazon. DataZone 

 DataZoneIl supporto di Amazon al driver JDBC Athena offre i seguenti vantaggi:
+ Maggiore scelta di strumenti per l'interrogazione e la visualizzazione: i consumatori di dati possono connettersi ad Amazon DataZone utilizzando i loro strumenti preferiti tra un'ampia gamma di strumenti di analisi che supportano una connessione JDBC. Ciò consente loro di continuare a utilizzare il software che conoscono senza la necessità di apprendere nuovi strumenti per il consumo di dati. 
+ Accesso programmatico: una connessione JDBC ai dati regolati dall'accesso tramite server o applicazioni personalizzate consente agli utenti di dati di eseguire operazioni automatizzate e più complesse sui dati.

Puoi utilizzare il tuo URL JDBC per collegare i tuoi strumenti di analisi esterni ai dati DataZone abbonati ad Amazon. Per ottenere il tuo URL JDBC, esegui la seguente procedura:

**Importante**  
Nella versione corrente, Amazon DataZone supporta l'autenticazione tramite il driver Amazon Athena JDBC. Per completare questa procedura, assicurati di aver scaricato e installato il [driver JDBC Athena](https://docs.aws.amazon.com/athena/latest/ug/jdbc-v3-driver.html) più recente per la tua applicazione di analisi preferita. 

1. Vai all'URL del portale DataZone dati di Amazon e accedi utilizzando Single Sign-On (SSO) o le tue credenziali. AWS Se sei un DataZone amministratore Amazon, puoi accedere alla DataZone console Amazon all'indirizzo [https://console.aws.amazon.com/datazone](https://console.aws.amazon.com/datazone) e accedere con il Account AWS luogo in cui è stato creato il dominio, quindi scegliere **Open** data portal.

1. Nel portale DataZone dati di Amazon, scegli **Browse Projects List**, quindi trova e scegli il progetto in cui hai i dati che desideri analizzare.

1. Nel pannello laterale destro della home page del progetto, scegli **Connect with JDBC**.

1. Nella finestra pop-up dei **parametri JDBC**, scegli il metodo di autenticazione (credenziali SSO o credenziali IAM), quindi copia la stringa o i singoli parametri dell'URL JDBC. Puoi quindi utilizzarlo per connetterti alla tua applicazione di analisi esterna. 

Quando colleghi la tua applicazione di analisi esterna ad Amazon DataZone utilizzando la query o i parametri JBDC, richiami l'API. `RedeemAccessToken` L'`RedeemAccessToken`API scambia un token di accesso Identity Center per le `AmazonDataZoneDomainExecutionRole` credenziali, che vengono utilizzate per chiamare l'API. `GetEnvironmentCredentials`

[Per ulteriori informazioni sul meccanismo di autenticazione che utilizza le credenziali IAM per connettersi ai dati DataZone gestiti da Amazon in Athena, consulta DataZone IAM Credentials Provider.](https://docs.aws.amazon.com/athena/latest/ug/jdbc-v3-driver-datazone-iamcp.html) Per ulteriori informazioni sul meccanismo di autenticazione che consente la connessione ai dati DataZone gestiti da Amazon in Athena utilizzando IAM Identity Center, [DataZone consulta Idc](https://docs.aws.amazon.com/athena/latest/ug/jdbc-v3-driver-datazone-idc.html) Credentials Provider.

## RedeemAccessToken Riferimento alle API
<a name="api-ref"></a>

**Sintassi della richiesta**

```
POST /sso/redeem-token HTTP/1.1
Content-type: application/json

{
   "domainId": "string",
   "accessToken": "string"
}
```

**Parametri della richiesta**

La richiesta utilizza i seguenti parametri.

**DomainId**  
L'ID del DataZone dominio Amazon.  
Modello: ^dzd [-\_] [a-zA-Z0-9\_-] {1,36} $   
Obbligatorio: sì

**Token di accesso**  
Il token di accesso a Identity Center.  
Tipo: stringa  
Obbligatorio: sì

**Sintassi della risposta**

```
HTTP/1.1 200
Content-type: application/json

{
   "credentials": AwsCredentials
}
```

**Elementi di risposta**

**credenziali**  
Le `AmazonDataZoneDomainExecutionRole` credenziali utilizzate per chiamare l'`GetEnvironmentCredentials`API.  
Tipo: matrice di `AwsCredentials` oggetti. Questo tipo di dati include le seguenti proprietà:  
+ accessKeyId: AccessKeyId
+ secretAccessKey: SecretAccessKey
+ Token di sessione: SessionToken
+ scadenza: timestamp

**Token di accesso**  
Il token di accesso a Identity Center.  
Tipo: stringa  
Obbligatorio: sì

**Errori**

**AccessDeniedException**  
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.  
Codice di stato HTTP: 403

**ResourceNotFoundException**  
La risorsa specificata non può essere trovata.  
Codice di stato HTTP: 404

**ValidationException**  
L'input non soddisfa i vincoli specificati dal AWS servizio.  
Codice di stato HTTP: 400

**InternalServerException**  
La richiesta non è riuscita a causa di un errore, un'eccezione o un errore sconosciuto.  
Codice di stato HTTP: 500