CREATE EXTERNAL TABLE

Nome della tabella da creare, qualificato da un nome di schema esterno. Le tabelle esterne devono essere create in uno schema esterno. Per ulteriori informazioni, consulta CREATE EXTERNAL SCHEMA.

La lunghezza massima per il nome della tabella è 127 byte; i nomi più lunghi vengono troncati a 127 byte. È possibile utilizzare UTF -8 caratteri multibyte fino a un massimo di quattro byte. Amazon Redshift applica un limite di 9.900 tabelle per cluster, comprese le tabelle temporanee definite dall'utente e le tabelle temporanee create da Amazon Redshift durante l'elaborazione delle query o la manutenzione del sistema. Facoltativamente, puoi qualificare il nome della tabella con il nome del database. Nell'esempio seguente, il nome del database è spectrum_db, il nome dello schema esterno è spectrum_schema e il nome della tabella è test.

create external table spectrum_db.spectrum_schema.test (c1 int)
stored as parquet
location 's3://amzn-s3-demo-bucket/myfolder/';

Se il database o lo schema specificato non esiste, la tabella non viene creata e l'istruzione restituisce un errore. Non è possibile creare tabelle o viste nei database di sistema template0, template1, padb_harvest o sys:internal.

Il nome della tabella deve essere un nome univoco per lo schema specificato.

Per ulteriori informazioni sui nomi validi, consultare Nomi e identificatori.

Il nome e il tipo di dati di ciascuna colonna creata.

La lunghezza massima per il nome della colonna è 127 byte; i nomi più lunghi vengono troncati a 127 byte. È possibile utilizzare UTF -8 caratteri multibyte fino a un massimo di quattro byte. Non puoi specificare i nomi di colonna "$path" o "$size". Per ulteriori informazioni sui nomi validi, consultare Nomi e identificatori.

Per impostazione predefinita, Amazon Redshift crea tabelle esterne con le pseudocolonne $path e $size. Puoi disabilitare la creazione di pseudocolonne per una sessione impostando il parametro di configurazione spectrum_enable_pseudo_columns su false. Per ulteriori informazioni, consulta Pseudocolonne .

Se le pseudocolonne sono abilitate, il numero massimo di colonne che è possibile definire in una singola tabella è 1.598. Se le pseudocolonne non sono abilitate, il numero massimo di colonne che puoi definire in una singola tabella è 1.600.

Se stai creando una "tabella di grandi dimensioni", assicurati che il tuo elenco di colonne non superi i limiti della larghezza delle righe per i risultati intermedi durante i carichi e l'elaborazione delle query. Per ulteriori informazioni, consulta Note per l'utilizzo.

Per un comando CREATE EXTERNAL TABLE AS, non è necessario un elenco di colonne, poiché le colonne derivano dalla query.

Sono supportate le seguenti Tipi di dati:

InfattiDATE, è possibile utilizzare i formati come descritto di seguito. Per i valori mensili rappresentati tramite cifre, sono supportati i seguenti formati:

Per i valori mensili rappresentati tramite l'abbreviazione di tre lettere, sono supportati i seguenti formati:

Per i valori dell'anno che sono costantemente inferiori a 100, l'anno viene calcolato nel modo seguente:

I valori di timestamp nei file di testo devono essere nel formato yyyy-mm-dd HH:mm:ss.SSSSSS, come il seguente valore di timestamp 2017-05-01 11:30:59.000000.

La lunghezza di una VARCHAR colonna è definita in byte, non in caratteri. Ad esempio, una colonna VARCHAR (12) può contenere 12 caratteri a byte singolo o 6 caratteri a due byte. Quando invii una query a una tabella esterna, i risultati sono troncati in modo da essere compatibili con le dimensioni definite della colonna senza restituire un errore. Per ulteriori informazioni, consulta Storage e intervalli.

Per garantire le prestazioni migliori, consigliamo di specificare le dimensioni della colonna più piccole compatibili con i dati. Per trovare la dimensione massima in byte per i valori in una colonna, utilizzare la funzione _. OCTET LENGTH Nell'esempio seguente viene restituita la dimensione massima dei valori nella colonna dell'e-mail.

select max(octet_length(email)) from users;

max
---
 62

Una clausola che definisce una tabella partizionata con una o più colonne di partizione. Viene utilizzata una directory di dati separata per ciascuna combinazione specificata, che può migliorare le prestazioni della query in alcune circostanze. Le colonne partizionate non esistono all'interno dei dati della tabella stessa. Se usi un valore per col_name uguale a una colonna della tabella, viene restituito un errore.

Dopo aver creato una tabella partizionata, modificatela utilizzando un'ADDPARTITIONistruzioneALTER TABLE... per registrare nuove partizioni nel catalogo esterno. Quando si aggiunge una partizione, si definisce la posizione della sottocartella su Amazon S3 contenenti i dati della partizione.

Ad esempio, se la tabella spectrum.lineitem_part è definita conPARTITIONED BY (l_shipdate date), esegui il ALTER TABLE comando seguente per aggiungere una partizione.

ALTER TABLE spectrum.lineitem_part ADD PARTITION (l_shipdate='1992-01-29')
LOCATION 's3://spectrum-public/lineitem_partition/l_shipdate=1992-01-29';

Se utilizzi CREATE EXTERNAL TABLE AS, non è necessario eseguire ALTERTABLE... ADDPARTITION. Amazon Redshift registra automaticamente le nuove partizioni nel catalogo esterno. Amazon Redshift scrive inoltre automaticamente i dati corrispondenti nelle partizioni Amazon S3 in base alla chiave o alle chiavi di partizione definite nella tabella.

Per visualizzare le partizioni, eseguire una query sulla vista di sistema SVV_EXTERNAL_PARTITIONS.

Clausola che specifica il formato dei dati sottostanti. I valori possibili di rowformat sono indicati di seguito:

Specificare un singolo ASCII carattere per 'delimiter'. È possibile specificare ASCII caratteri non stampabili utilizzando l'ottale, nel formato in '\ ddd'cui dè una cifra ottale (0—7) fino a '\ 177'. L'esempio seguente specifica il carattere (bell) utilizzando l'ottale. BEL

ROW FORMAT DELIMITED FIELDS TERMINATED BY '\007'

Se ROW FORMAT viene omesso, il formato predefinito è DELIMITED FIELDS TERMINATED BY '\ A' (inizio del titolo) e LINES TERMINATED BY'\n'(nuova riga).

Una clausola che specifica il formato dei dati sottostanti. SERDE

Se ROW FORMAT viene omesso, il formato predefinito è DELIMITED FIELDS TERMINATED BY '\ A' (inizio del titolo) e LINES TERMINATED BY'\n'(nuova riga).

Il formato per i file di dati.

I formati validi sono:

Il CREATE EXTERNAL TABLE comando AS supporta solo due formati di file e. TEXTFILE PARQUET

Per INPUTFORMAT eOUTPUTFORMAT, specificate un nome di classe, come illustrato nell'esempio seguente.

'org.apache.hadoop.mapred.TextInputFormat'

Il percorso della cartella o del bucket Amazon S3 con i file di dati o un file manifest che contiene un elenco di percorsi di oggetti Amazon S3. I bucket devono trovarsi nella stessa AWS regione del cluster Amazon Redshift. Per un elenco delle AWS regioni supportate, consulta. Limitazioni di Amazon Redshift Spectrum

Se il percorso specifica un bucket o una cartella, ad esempio 's3://amzn-s3-demo-bucket/custdata/', Redshift Spectrum esegue la scansione dei file nel bucket o nella cartella specificati e in qualsiasi sottocartella. Redshift Spectrum ignora i file e i file nascosti che iniziano con un punto o un trattino basso.

Se il percorso specifica un file manifest, l'argomento 's3://bucket/manifest_file' deve fare riferimento esplicitamente a un singolo file, ad esempio 's3://amzn-s3-demo-bucket/manifest.txt'. Non può fare riferimento a un prefisso della chiave.

Il manifesto è un file URL di testo in JSON formato che elenca ogni file da caricare da Amazon S3 e la dimensione del file, in byte. URLInclude il nome del bucket e il percorso completo dell'oggetto per il file. I file specificati nel manifesto possono trovarsi in diversi bucket, ma tutti i bucket devono trovarsi nella stessa AWS regione del cluster Amazon Redshift. Se un file viene elencato due volte, viene caricato due volte. L'esempio seguente mostra il JSON codice di un manifesto che carica tre file.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

È possibile rendere obbligatoria l'inclusione di un particolare file. A tale scopo, includere un'opzione mandatory a livello di file nel manifest. Quando si esegue una query su una tabella esterna con un file obbligatorio mancante, l'SELECTistruzione ha esito negativo. Assicurarsi che tutti i file inclusi nella definizione della tabella esterna siano presenti. Se non sono tutti presenti, viene visualizzato un errore che mostra il primo file obbligatorio che non viene trovato. L'esempio seguente mostra l'opzione JSON per un manifesto con l'mandatoryopzione impostata sutrue.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "mandatory":true, "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "mandatory":false, "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

Per fare riferimento ai file creati utilizzandoUNLOAD, è possibile utilizzare il manifesto creato utilizzando UNLOAD il MANIFEST parametro. Il file manifest è compatibile con un file manifest per COPYda Amazon S3, ma usa chiavi diverse. Le chiavi non utilizzate vengono ignorate.

Clausola che imposta la definizione della tabella delle proprietà della tabella.