UNLOAD

Query SELECT. I risultati della query vengono scaricati. Nella maggior parte dei casi, vale la pena scaricare i dati nell'ordine ordinato specificando una clausola ORDER BY nella query. Questo approccio risparmia il tempo richiesto per ordinare i dati quando vengono ricaricati.

La query deve essere racchiusa tra virgolette singole, come mostrato di seguito:

('select * from venue order by venueid')

('select * from venue where venuestate=''NV''')

Il percorso completo, incluso il nome del bucket, nella posizione su Amazon S3 dove Amazon Redshift scrive gli oggetti del file di output, incluso il file manifest se è specificato MANIFEST. Ai nomi degli oggetti viene anteposto name-prefix. Se si utilizza PARTITION BY, viene aggiunta automaticamente una barra alla fine del valore name-prefix, se necessario. Per maggiore sicurezza, UNLOAD si collega ad Amazon S3 utilizzando una connessione HTTPS. Per impostazione predefinita, UNLOAD scrive uno o più file per sezione. UNLOAD aggiunge un numero di sezioni e un numero di parte al prefisso del nome specificato come segue:

<object-path>/<name-prefix><slice-number>_part_<part-number>.

Se viene specificato MANIFEST, il file manifest viene scritto come segue:

<object_path>/<name_prefix>manifest.

Se PARALLEL è specificato OFF, i file di dati vengono scritti come segue:

<object_path>/<name_prefix><part-number>.

UNLOAD crea automaticamente file crittografati usando la crittografia lato server (SSE) Amazon S3, incluso il file manifest se viene utilizzato MANIFEST. Il comando COPY legge automaticamente i file crittografati sul lato server durante l'operazione di caricamento. È possibile scaricare in modo trasparente i file crittografati sul lato server dal bucket utilizzando la console di Amazon S3 o l'API. Per ulteriori informazioni, consultare Protezione dei dati con la crittografia lato server.

Per usare la crittografia lato client di Amazon S3, specificare l'opzione ENCRYPTED.

Il comando UNLOAD necessita l'autorizzazione per scrivere dati in Amazon S3. Il comando UNLOAD utilizza gli stessi parametri usati dal comando COPY per l'autorizzazione. Per ulteriori informazioni, consultare Parametri di autorizzazione nel riferimento della sintassi del comando COPY.

Utilizzare la parola chiave predefinita per fare in modo che Amazon Redshift utilizzi il ruolo IAM impostato come predefinito e associato al cluster quando viene eseguito il comando UNLOAD.

L'Amazon Resource Name (ARN) per un ruolo IAM utilizzato dal cluster per l'autenticazione e l'autorizzazione. Se specifichi IAM_ROLE, non è possibile utilizzare ACCESS_KEY_ID e SECRET_ACCESS_KEY, SESSION_TOKEN o CREDENTIALS. IAM_ROLE può essere concatenato. Per ulteriori informazioni, consulta Concatenazione di ruoli IAM nella Guida alla gestione di Amazon Redshift.

Le parole chiave per specificare il formato di scarico che sovrascrive il formato predefinito.

Scarica in un file di testo in formato CSV utilizzando una virgola (,) come delimitatore predefinito. Se un campo contiene delimitatori, virgolette doppie, caratteri newline o ritorni a capo, il campo nel file scaricato è racchiuso tra virgolette doppie. A una virgoletta doppia all'interno di un campo dati viene aggiunta un'ulteriore virgoletta doppia. Quando vengono scaricate zero righe, Amazon Redshift potrebbe scrivere oggetti Amazon S3 vuoti.

Nel caso di PARQUET, viene scaricata in un file in formato Apache Parquet versione 1.0. Per impostazione predefinita, ogni gruppo di righe viene compresso mediante la compressione SNAPPY. Per ulteriori informazioni sul formato Apache Parquet, consultare Parquet.

Nel caso di JSON, scarica in un file JSON con ogni riga contenente un oggetto JSON, che rappresenta un record completo nel risultato della query. Amazon Redshift supporta la scrittura di JSON nidificati quando il risultato della query contiene colonne SUPER. Per creare un oggetto JSON valido, il nome di ogni colonna della query deve essere univoco. Nel file JSON, i valori booleani vengono scaricati come t o f e i valori NULL vengono scaricati come null. Quando vengono scaricate zero righe, Amazon Redshift non scrive oggetti Amazon S3 vuoti.

Le parole chiave FORMAT e AS sono facoltative. Non puoi usare CSV con ESCAPE, FIXEDWIDTH o ADDQUOTES. Non è possibile utilizzare PARQUET con DELIMITER, FIXEDWIDTH, ADDQUOTES, ESCAPE, NULL AS, HEADER, GZIP o ZSTD. BZIP2 PARQUET con ENCRYPTED è supportato solo con la crittografia lato server con una chiave (SSE-KMS). AWS Key Management Service Non è possibile utilizzare JSON con DELIMITER, HEADER, FIXEDWIDTH, ADDQUOTES, ESCAPE o NULL AS.

Specifica le chiavi di partizione per l'operazione di scaricamento. UNLOAD suddivide automaticamente i file di output in cartelle di partizione in base ai valori chiave di partizione, secondo la convenzione Apache Hive. Ad esempio, un file Parquet che appartiene all'anno di partizione 2019 e al mese di settembre ha il seguente prefisso: s3://amzn-s3-demo-bucket/my_prefix/year=2019/month=September/000.parquet.

Il valore per column_name deve essere una colonna nei risultati della query che vengono scaricati.

Se si specifica PARTITION BY con l'opzione INCLUDE, le colonne delle partizioni non vengono rimosse dai file scaricati.

Amazon Redshift non supporta letterali stringa nelle clausole PARTITION BY.

Crea un file manifest che elenca esplicitamente i dettagli per dati creati dal processo UNLOAD. Il manifest è un file di testo in formato JSON che elenca l'URL di ciascun file scritto in Amazon S3.

Se viene specificato MANIFEST con l'opzione VERBOSE, il manifest include i seguenti dettagli:

Puoi specificare VERBOSE solo dopo MANIFEST.

Il file manifest è scritto nello stesso prefisso del percorso Amazon S3 come file scaricati nel formato <object_path_prefix>manifest. Ad esempio, se UNLOAD specifica il prefisso del percorso di Amazon S3 's3://amzn-s3-demo-bucket/venue_', il percorso del file manifest sarà 's3://amzn-s3-demo-bucket/venue_manifest'.

Aggiunge una riga di intestazione che contiene i nomi delle colonne nella parte superiore di ogni file output. Anche le opzioni di trasformazione del testo, come CSV, DELIMITER, ADDQUOTES ed ESCAPE, si applicano alla riga di intestazione. Non è possibile utilizzare HEADER con FIXEDWIDTH.

Specifica un singolo carattere ASCII utilizzato per separare i campi del file di output, ad esempio un carattere pipe ( | ), una virgola ( , ) o una tabulazione ( \t ). Il delimitatore predefinito per i file di testo è un carattere pipe. Il delimitatore predefinito per i file CSV è una virgola. La parola chiave AS è facoltativa. Non è possibile utilizzare DELIMITER con FIXEDWIDTH. Se i dati contengono il carattere delimitatore, è necessario specificare l'opzione ESCAPE per evitare il delimitatore o utilizzare ADDQUOTES per racchiudere i dati tra virgolette doppie. In alternativa, specifica un delimitatore non contenuto nei dati.

Scarica i dati in un file in cui ogni larghezza di colonna è fissa, invece di essere separate da un delimitatore. La stringa fixedwidth_spec specifica il numero di colonne e la larghezza delle colonne. La parola chiave AS è facoltativa. Poiché FIXEDWIDTH non tronca i dati, la specifica per ogni colonna nell'istruzione UNLOAD deve essere lunga almeno quanto la lunghezza della voce più lunga per quella colonna. Di seguito è indicato il formato di fixedwidth_spec:

'colID1:colWidth1,colID2:colWidth2, ...'

Non è possibile utilizzare FIXEDWIDTH con DELIMITER o HEADER.

Specifica che i file di output in Amazon S3 saranno crittografati usando la crittografia lato server o la crittografia lato client di Amazon S3. Se viene specificato MANIFEST, anche il file manifest viene crittografato. Per ulteriori informazioni, consulta Scaricamento di file di dati crittografati. Se non specifichi il parametro ENCRYPTED, UNLOAD crea automaticamente file crittografati utilizzando la crittografia lato server di Amazon S3 AWS con chiavi di crittografia gestite (SSE-S3).

Per ENCRYPTED, potresti voler scaricare su Amazon S3 utilizzando la crittografia lato server con AWS KMS una chiave (SSE-KMS). In tal caso, utilizza il parametro KMS_KEY_ID per fornire l'ID della chiave. Non puoi usare il parametro CREDENTIALS con il parametro KMS_KEY_ID. Se esegui un comando UNLOAD per i dati utilizzando KMS_KEY_ID, puoi eseguire un'operazione COPY per gli stessi dati senza specificare una chiave.

Per scaricare in Amazon S3 utilizzando la crittografia lato client con una chiave simmetrica fornita dal cliente fornisce la chiave in due modi. Per fornire la chiave, utilizza il parametro MASTER_SYMMETRIC_KEY o la parte master_symmetric_key di una stringa di credenziali CREDENTIALS. Se scarichi i dati utilizzando una chiave simmetrica master, assicurati di fornire la stessa chiave quando esegui un'operazione COPY per i dati crittografati.

UNLOAD non supporta la crittografia lato server di Amazon S3 con una chiave fornita dal cliente (SSE-C).

Se viene utilizzato ENCRYPTED AUTO, il comando UNLOAD recupera la chiave di AWS KMS crittografia predefinita sulla proprietà del bucket Amazon S3 di destinazione e crittografa i file scritti su Amazon S3 con la chiave. AWS KMS Se il bucket non dispone della chiave di AWS KMS crittografia predefinita, UNLOAD crea automaticamente file crittografati utilizzando la crittografia lato server di Amazon Redshift AWS con chiavi di crittografia gestite (SSE-S3). Non è possibile utilizzare questa opzione con KMS_KEY_ID, MASTER_SYMMETRIC_KEY o CREDENTIALS contenente master_symmetric_key.

Speciifica l'ID della chiave per una chiave AWS Key Management Service (AWS KMS) da utilizzare per crittografare i file di dati su Amazon S3. Per ulteriori informazioni, consulta What is? AWS Key Management Service Se specifichi KMS_KEY_ID, devi specificare anche il parametro ENCRYPTED. Se specifichi KMS_KEY_ID, non puoi autenticare usando il parametro CREDENTIALS. Utilizza invece IAM_ROLE o ACCESS_KEY_ID and SECRET_ACCESS_KEY.

La chiave simmetrica master da utilizzare per crittografare i file di dati in Amazon S3. Se specifichi il parametro MASTER_SYMMETRIC_KEY, devi anche specificare il parametro ENCRYPTED. Non è possibile utilizzare MASTER_SYMMETRIC_KEY con il parametro CREDENTIALS. Per ulteriori informazioni, consulta Caricamento di file di dati crittografati da Amazon S3.

Scarica i dati in uno o più file compressi con bzip2 per sezione. A ogni file risultante viene aggiunta l'estensione .bz2.

Scarica i dati in uno o più file compressi con gzip per sezione. A ogni file risultante viene aggiunta l'estensione .gz.

Scarica i dati in uno o più file compressi con Zstandard per sezione. A ogni file risultante viene aggiunta l'estensione .zst.

Mettere le virgolette attorno a ciascun campo dati scaricato, in modo che Amazon Redshift possa scaricare i valori dei dati che contengono il delimitatore stesso. Ad esempio, se il delimitatore è una virgola, puoi scaricare e ricaricare i seguenti dati:

 "1","Hello, World" 

Senza le virgolette aggiunte, la stringa Hello, World verrebbe analizzata come due campi separati.

Alcuni formati di output non supportano ADDQUOTES.

Se usi ADDQUOTES, devi specificare REMOVEQUOTES nel parametro COPY se ricarichi i dati.

Specifica una stringa che rappresenta un valore null nei file scaricato. Se si utilizza questa opzione, tutti i file di output contengono la stringa specificata al posto di qualsiasi valore null trovato nei dati selezionati. Se questa opzione non è specificata, i valori null vengono scaricati come:

Se viene specificata una stringa null per uno scaricamento a larghezza fissa e la larghezza di una colonna di output è inferiore alla larghezza della stringa null, si verifica il seguente comportamento:

A differenza di altri tipi di dati in cui una stringa definita dall'utente rappresenta un valore nullo, Amazon Redshift esporta le colonne di dati SUPER utilizzando il formato JSON e li rappresenta come null come determinato dal formato JSON. Di conseguenza, le colonne di dati SUPER ignorano l'opzione NULL [AS] utilizzata nei comandi UNLOAD.

Per le colonne CHAR e VARCHAR in file scaricati delimitati, un carattere di escape (\) viene inserito prima di ogni occorrenza dei seguenti caratteri:

Per impostazione predefinita, UNLOAD ha esito negativo se trova i file che potrebbe sovrascrivere. Se è specificato ALLOWOVERWRITE, UNLOAD sovrascrive i file esistenti, incluso il file manifest.

L'opzione CLEANPATH rimuove i file esistenti che si trovano nel percorso Amazon S3 specificato nella clausola TO prima di scaricare i file nella posizione specificata.

Se si include la clausola PARTITION BY, i file esistenti vengono rimossi solo dalle cartelle delle partizioni per ricevere i nuovi file generati dall'operazione UNLOAD.

È necessario disporre dell'autorizzazione s3:DeleteObject sul bucket Amazon S3. Per ulteriori informazioni, consultare Policy e autorizzazioni in Amazon S3 nella Guida per l'utente di Amazon Simple Storage Service. I file rimossi utilizzando l'opzione CLEANPATH vengono eliminati in modo definitivo e non possono essere recuperati. Se il bucket Amazon S3 di destinazione ha il controllo delle versioni abilitato, UNLOAD con l'opzione CLEANPATH non rimuove le versioni precedenti dei file.

Non è possibile specificare l'opzione CLEANPATH se si specifica l'opzione ALLOWOVERWRITE.

Per impostazione predefinita, UNLOAD scrive i dati in parallelo in più file, in base al numero di sezioni nel cluster. L'opzione predefinita è ON o TRUE. Se PARALLEL è OFF o FALSE, UNLOAD scrive in uno o più file di dati in serie, ordinati in modo assoluto in base alla clausola ORDER BY, se utilizzata. Le dimensioni massime per un file di dati sono di 6,2 GB. Ad esempio, se scarichi 13,4 GB di dati, UNLOAD crea i seguenti tre file.

s3://amzn-s3-demo-bucket/key000    6.2 GB
s3://amzn-s3-demo-bucket/key001    6.2 GB
s3://amzn-s3-demo-bucket/key002    1.0 GB

Specificare la dimensione massima dei file creati da UNLOAD in Amazon S3. Specifica un valore decimale compreso tra 5 MB e 6,2 GB. La parola chiave AS è facoltativa. L'unità predefinita è MB. Se MAXFILESIZE non è specificato, la dimensione massima del file predefinita è 6,2 GB. MAXFILESIZE non influisce sulle dimensioni del file manifest, se utilizzato.

Specifica le dimensioni dei gruppi di righe. La scelta di dimensioni maggiori può ridurre il numero di gruppi di righe, riducendo la quantità di comunicazioni di rete. Specificare un valore intero compreso tra 32 MB e 128 MB. La parola chiave AS è facoltativa. L'unità predefinita è MB.

Se non è specificato ROWGROUPSIZE, la dimensione predefinita è 32 MB. Per utilizzare questo parametro, il formato di archiviazione deve essere Parquet e il tipo di nodo deve essere ra3.4xlarge, ra3.16xlarge o dc2.8xlarge.

Speciifica Regione AWS dove si trova il bucket Amazon S3 di destinazione. REGION è necessario per UNLOAD su un bucket Amazon S3 che non si trova nello Regione AWS stesso database Amazon Redshift.

Il valore per aws_region deve corrispondere a una AWS regione elencata nella tabella delle regioni e degli endpoint di Amazon Redshift nel. Riferimenti generali di AWS

Per impostazione predefinita, UNLOAD presuppone che il bucket Amazon S3 di destinazione si trovi nello stesso database Amazon Regione AWS Redshift.

Specifica l'estensione del file da aggiungere ai nomi dei file scaricati. Amazon Redshift non esegue alcuna convalida, quindi è necessario verificare che l'estensione del file specificata sia corretta. Se specifichi un metodo di compressione senza fornire un'estensione, Amazon Redshift aggiunge solo l'estensione del metodo di compressione al nome del file. Se non fornisci alcuna estensione e non specifichi un metodo di compressione, Amazon Redshift non aggiunge nulla al nome del file.