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à.

Utilizzo dei dati di Amazon Redshift API

Amazon Redshift Data API semplifica l'accesso al tuo data warehouse Amazon Redshift eliminando la necessità di gestire driver di database, connessioni, configurazioni di rete, buffering dei dati, credenziali e altro ancora. Puoi eseguire SQL istruzioni utilizzando le operazioni Data con. API AWS SDK Per ulteriori informazioni sulle API operazioni relative ai dati, consulta Amazon Redshift Data API Reference.

I dati API non richiedono una connessione persistente al database. Fornisce invece un HTTP endpoint sicuro e un'integrazione con AWS SDKs. È possibile utilizzare l'endpoint per eseguire SQL istruzioni senza gestire le connessioni. Le chiamate ai dati API sono asincrone. I dati API utilizzano credenziali archiviate nel database o credenziali temporanee del AWS Secrets Manager database. Non è necessario passare le password nelle API chiamate con nessuno dei due metodi di autorizzazione. Per ulteriori informazioni su AWS Secrets Manager, consulta What Is? AWS Secrets Manager nella Guida AWS Secrets Manager per l'utente.

Con The DataAPI, puoi accedere in modo programmatico ai dati di Amazon Redshift con applicazioni basate su servizi Web, AWS Lambda tra cui notebook Amazon e. SageMaker AWS Cloud9 Per ulteriori informazioni su queste applicazioni AWS Lambda, consulta Amazon SageMaker e AWS Cloud9.

Per ulteriori informazioni sui datiAPI, consulta la sezione Introduzione ai dati di Amazon Redshift API nel blog sui AWS Big Data.

Lavorare con i dati di Amazon Redshift API

Prima di utilizzare Amazon Redshift DataAPI, esamina i seguenti passaggi:

Considerazioni sulla chiamata di Amazon Redshift Data API

Considera quanto segue quando chiami i datiAPI:

Scelta delle credenziali di autenticazione del database quando si chiama Amazon Redshift Data API

Con questi metodi, puoi anche fornire un region valore che specifica Regione AWS dove si trovano i tuoi dati.

Mappatura JDBC dei tipi di dati quando si richiama Amazon Redshift Data API

La tabella seguente mappa i tipi di dati Java Database Connectivity (JDBC) ai tipi di dati specificati nelle API chiamate di dati.

I valori stringa vengono passati al database Amazon Redshift e convertiti implicitamente in un tipo di dati del database.

Esecuzione di SQL istruzioni con parametri durante la chiamata ad Amazon Redshift Data API

È possibile controllare il SQL testo inviato al motore di database chiamando l'APIoperazione Data utilizzando i parametri relativi a parti dell'SQListruzione. I parametri denominati forniscono un modo flessibile per passare i parametri senza codificarli nel SQL testo. Ti aiutano a riutilizzare il SQL testo ed evitare problemi SQL di iniezione.

L'esempio seguente mostra i parametri denominati di un parameters campo di un execute-statement AWS CLI comando.

--parameters "[{\"name\": \"id\", \"value\": \"1\"},{\"name\": \"address\", \"value\": \"Seattle\"}]"

Considerare le informazioni seguenti durante l'utilizzo dei parametri specificati:

Esecuzione di SQL istruzioni con un token di idempotenza durante la chiamata ad Amazon Redshift Data API

Quando si effettua una richiesta mutante, la API richiesta restituisce in genere un risultato prima del completamento dei flussi di lavoro asincroni dell'operazione. Le operazioni potrebbero inoltre scadere o riscontrare altri problemi relativi al server prima del completamento, anche se la richiesta ha già restituito un risultato. Ciò potrebbe rendere difficile determinare l'esito della richiesta e potrebbe comportare più tentativi per garantire che l'operazione venga completata correttamente. Tuttavia, se la richiesta originale e i tentativi successivi hanno esito positivo, l'operazione viene completata più volte, il che significa che potresti aggiornare più risorse del previsto.

L'idempotenza garantisce che una richiesta venga completata non più di una voltaAPI. Quando si utilizza una richiesta idempotente, se la richiesta originale viene completata correttamente, tutti i tentativi successivi vengono completati correttamente senza alcuna azione aggiuntiva. I dati API ExecuteStatement e le BatchExecuteStatement operazioni hanno un parametro idempotente opzionale. ClientToken Il ClientToken scade dopo 8 ore.

Il execute-statement AWS CLI comando seguente illustra il client-token parametro opzionale per l'idempotenza.

aws redshift-data execute-statement 
    --region us-west-2 
    --secret arn:aws:secretsmanager:us-west-2:123456789012:secret:myuser-secret-hKgPWn 
    --cluster-identifier mycluster-test 
    --sql "select * from stl_query limit 1" 
    --database dev 
    --client-token b855dced-259b-444c-bc7b-d3e8e33f94g1                       

La tabella seguente mostra alcune risposte comuni che è possibile ottenere per richieste idempotenti e fornisce consigli API per riprovare.

Per informazioni sui codici di risposta di Amazon Redshift, consulta Errori comuni in Amazon API Redshift Reference.

Esecuzione di SQL istruzioni con riutilizzo della sessione quando si richiama Amazon Redshift Data API

Quando si effettua una API richiesta per eseguire un'SQListruzione, la sessione in cui SQL viene eseguita viene in genere terminata al termine dellaSQL. Per mantenere attiva la sessione per un determinato numero di secondi, i dati API ExecuteStatement e BatchExecuteStatement le operazioni dispongono di un SessionKeepAliveSeconds parametro opzionale. Un campo di SessionId risposta contiene l'identità della sessione che può quindi essere utilizzata nelle BatchExecuteStatement operazioni ExecuteStatement e nelle operazioni successive. Nelle chiamate successive è possibile specificarne un'altra SessionKeepAliveSeconds per modificare il tempo di timeout di inattività. Se il non SessionKeepAliveSeconds viene modificato, l'impostazione iniziale del timeout di inattività rimane. Quando utilizzate il riutilizzo della sessione, tenete presente quanto segue:

Per recuperare SessionId ciò che viene utilizzato dalle chiamate e dalle BatchExecuteStatement operazioni, dalle chiamate ExecuteStatement e dalle operazioni. DescribeStatement ListStatements

L'esempio seguente dimostra l'utilizzo dei SessionId parametri SessionKeepAliveSeconds and per mantenere attiva e riutilizzata una sessione. Innanzitutto, chiamate il execute-statement AWS CLI comando con il session-keep-alive-seconds parametro opzionale impostato su. 2

aws redshift-data execute-statement 
    --session-keep-alive-seconds 2 
    --sql "select 1" 
    --database dev 
    --workgroup-name mywg                     

La risposta contiene l'identificatore di sessione.

{
    "WorkgroupName": "mywg",
    "CreatedAt": 1703022996.436,
    "Database": "dev",
    "DbUser": "awsuser",
    "Id": "07c5ffea-76d6-4786-b62c-4fe3ef529680",
    "SessionId": "5a254dc6-4fc2-4203-87a8-551155432ee4"
}

Quindi, chiama il execute-statement AWS CLI comando con il SessionId risultato della prima chiamata. E, facoltativamente, specifica il session-keep-alive-seconds parametro impostato su 10 per modificare il valore del timeout di inattività.

aws redshift-data execute-statement 
    --sql "select 1" 
    --session-id 5a254dc6-4fc2-4203-87a8-551155432ee4
    --session-keep-alive-seconds 10