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

Salvataggio di dati da un cluster Amazon Aurora My SQL DB in file di testo in un bucket Amazon S3

Puoi utilizzare l'SELECT INTO OUTFILE S3istruzione per interrogare i dati da un cluster Amazon Aurora My SQL DB e salvarli in file di testo archiviati in un bucket Amazon S3. In Aurora MySQL, i file vengono prima archiviati sul disco locale e quindi esportati su S3. Al termine delle esportazioni, i file locali vengono eliminati.

Puoi crittografare il bucket Amazon S3 utilizzando una chiave gestita Amazon S3 (-S3) o SSE (-: AWS KMS key o SSE una chiave gestita dal cliente). KMS Chiave gestita da AWS

L'LOAD DATA FROM S3istruzione può utilizzare i file creati dall'SELECT INTO OUTFILE S3istruzione per caricare dati in un cluster Aurora DB. Per ulteriori informazioni, consulta Caricamento di dati in un cluster Amazon Aurora My SQL DB da file di testo in un bucket Amazon S3.

Concedere ad Aurora My SQL l'accesso ad Amazon S3

Prima di poter salvare i dati in un bucket Amazon S3, devi prima concedere al cluster Aurora My SQL DB l'autorizzazione ad accedere ad Amazon S3.

Concessione dei privilegi per il salvataggio dei dati in Aurora My SQL

L'utente del database che emette l'istruzione SELECT INTO OUTFILE S3 deve avere un ruolo o un privilegio specifico. In Aurora My SQL version 3, concedi il AWS_SELECT_S3_ACCESS ruolo. In Aurora My SQL version 2, concedi il SELECT INTO S3 privilegio. All'utente amministrativo per un cluster di database è concesso il ruolo o il privilegio appropriato per impostazione predefinita. Puoi concedere il privilegio a un altro utente usando le seguenti istruzioni.

Usa la seguente dichiarazione per Aurora My SQL versione 3:

GRANT AWS_SELECT_S3_ACCESS TO 'user'@'domain-or-ip-address'

Usa la seguente dichiarazione per Aurora My SQL versione 2:

GRANT SELECT INTO S3 ON *.* TO 'user'@'domain-or-ip-address'

Il AWS_SELECT_S3_ACCESS ruolo e il SELECT INTO S3 privilegio sono specifici di Amazon Aurora SQL My e non sono disponibili per i miei database RDS o per le SQL istanze SQL My DB. Se è stata impostata la replica tra un cluster Aurora SQL My DB come origine di replica e un database SQL My come client di replica, l'istruzione per il ruolo o GRANT il privilegio causa l'interruzione della replica con un errore. Puoi ignorare l'errore in modo sicuro per riprendere la replica. Per ignorare l'errore su un'istanza RDS for My SQL DB, usa la procedura mysql_rds_skip_repl_error. Per ignorare l'errore su un SQL database My esterno, utilizzate la variabile di sistema slave_skip_errors (Aurora My SQL versione 2) o la variabile di sistema replica_skip_errors (Aurora My versione 3). SQL

Specifica di un percorso in un bucket Amazon S3

La sintassi per specificare un percorso per archiviare i file manifest e di dati in un bucket Amazon S3 è simile a quella utilizzata nell'istruzione LOAD DATA FROM S3 PREFIX, come mostrato di seguito.

s3-region://bucket-name/file-prefix

Il percorso include i seguenti valori:

I file di dati creati dall'SELECT INTO OUTFILE S3istruzione utilizzano il seguente percorso, in cui 00000 rappresenta un numero intero a 5 cifre con base zero.

s3-region://bucket-name/file-prefix.part_00000

Ad esempio, supponiamo che un'istruzione SELECT INTO OUTFILE S3 specifichi s3-us-west-2://bucket/prefix come percorso in cui archiviare i file di dati e crea tre file di dati. Il bucket Amazon S3 specificato contiene i seguenti file di dati.

Creazione di un manifest per elencare i fili di dati

È possibile utilizzare l'SELECT INTO OUTFILE S3istruzione con l'MANIFEST ONopzione per creare un file manifesto in JSON formato che elenchi i file di testo creati dall'istruzione. L'LOAD DATA FROM S3istruzione può utilizzare il file manifest per caricare nuovamente i file di dati in un cluster Aurora My SQL DB. Per ulteriori informazioni sull'utilizzo di un manifest per caricare file di dati da Amazon S3 in un cluster Aurora My SQL DB, consulta. Utilizzo di un manifest per specificare i file di dati da caricare

I file di dati inclusi nel manifest creati dall'istruzione SELECT INTO OUTFILE S3 sono elencati nell'ordine in cui vengono creati dall'istruzione. Ad esempio, supponiamo che un'istruzione SELECT INTO OUTFILE S3 specifichi s3-us-west-2://bucket/prefix come percorso in cui archiviare i file di dati e crea tre file di dati e un file manifest. Il bucket Amazon S3 specificato contiene un file manifest denominato s3-us-west-2://bucket/prefix.manifest che contiene le seguenti informazioni.

{
  "entries": [
    {
      "url":"s3-us-west-2://bucket/prefix.part_00000"
    },
    {
      "url":"s3-us-west-2://bucket/prefix.part_00001"
    },
    {
      "url":"s3-us-west-2://bucket/prefix.part_00002"
    }
  ]
}

SELECTINTOOUTFILES3

Puoi usare l'istruzione SELECT INTO OUTFILE S3 per eseguire una query sui dati da un cluster DB e salvarlo direttamente nei file di testo delimitato archiviati in un bucket Amazon S3.

I file compressi non sono supportati. I file crittografati sono supportati a partire dalla SQL versione 2.09.0 di Aurora My.

Sintassi

SELECT
    [ALL | DISTINCT | DISTINCTROW ]
        [HIGH_PRIORITY]
        [STRAIGHT_JOIN]
        [SQL_SMALL_RESULT] [SQL_BIG_RESULT] [SQL_BUFFER_RESULT]
        [SQL_CACHE | SQL_NO_CACHE] [SQL_CALC_FOUND_ROWS]
    select_expr [, select_expr ...]
    [FROM table_references
        [PARTITION partition_list]
    [WHERE where_condition]
    [GROUP BY {col_name | expr | position}
        [ASC | DESC], ... [WITH ROLLUP]]
    [HAVING where_condition]
    [ORDER BY {col_name | expr | position}
         [ASC | DESC], ...]
    [LIMIT {[offset,] row_count | row_count OFFSET offset}]
INTO OUTFILE S3 's3_uri'
[CHARACTER SET charset_name]
    [export_options]
    [MANIFEST {ON | OFF}]
    [OVERWRITE {ON | OFF}]
    [ENCRYPTION {ON | OFF | SSE_S3 | SSE_KMS ['cmk_id']}]

export_options:
    [FORMAT {CSV|TEXT} [HEADER]]
    [{FIELDS | COLUMNS}
        [TERMINATED BY 'string']
        [[OPTIONALLY] ENCLOSED BY 'char']
        [ESCAPED BY 'char']
    ]
    [LINES
        [STARTING BY 'string']
        [TERMINATED BY 'string']
]

Parametri

L'istruzione SELECT INTO OUTFILE S3 utilizza i seguenti parametri obbligatori e facoltativi specifici per Aurora.

Puoi trovare maggiori dettagli su altri parametri nelle istruzioni e LOAD DATA nelle istruzioni, nella SELECTdocumentazione personale. SQL

Considerazioni

Il numero di file scritti nel bucket Amazon S3 dipende dalla quantità di dati selezionata dall'SELECT INTO OUTFILE S3istruzione e dalla soglia di dimensione del file per Aurora My. SQL La soglia della dimensione del file predefinita è 6 gigabyte (GB). Se i dati selezionati dall'istruzione sono inferiori alla soglia della dimensione del file, viene creato un singolo file; in caso contrario, vengono creati più file. Altre considerazioni per i file creati da questa dichiarazione includono quanto segue:

L'SELECT INTO OUTFILE S3istruzione restituisce un tipico numero di SQL errore My e una risposta in caso di esito positivo o negativo. Se non hai accesso al numero di SQL errore e alla risposta di My error, il modo più semplice per determinare quando è stato completato è specificarlo MANIFEST ON nell'istruzione. Il file manifest è l'ultimo file scritto dall'istruzione. In altre parole, se hai un file manifest, l'istruzione ha completato.

Al momento non è possibile monitorare direttamente l'avanzamento dell'istruzione SELECT INTO OUTFILE S3 durante l'esecuzione. Tuttavia, supponiamo che tu stia scrivendo una grande quantità di dati da Aurora SQL My ad Amazon S3 utilizzando questa istruzione e che tu conosca la dimensione dei dati selezionati dall'istruzione. In questo caso, puoi stimare l'avanzamento monitorando la creazione di file di dati in Amazon S3.

Per fare ciò, è possibile utilizzare il fatto che un file di dati viene creato nel bucket Amazon S3 specificato ogni circa 6 GB di dati selezionati dall'istruzione. Dividi la dimensione dei dati selezionati da 6 GB per ottenere il numero stimato di file di dati da creare. È quindi possibile stimare l'avanzamento dell'istruzione monitorando il numero di file caricati in Amazon S3 durante l'esecuzione.

Esempi

L'istruzione seguente seleziona tutti i dati nella employees tabella e li salva in un bucket Amazon S3 che si trova in una regione diversa dal cluster Aurora My DB. SQL L'istruzione crea file di dati in cui ogni campo è terminato da una virgola (,) e ogni riga è terminata da un carattere di nuova riga (\n). L'istruzione restituisce un errore se i file che corrispondono al prefisso del file sample_employee_data esistono nel bucket Amazon S3 specificato.

SELECT * FROM employees INTO OUTFILE S3 's3-us-west-2://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n';

L'istruzione seguente seleziona tutti i dati nella employees tabella e li salva in un bucket Amazon S3 che si trova nella stessa regione del cluster Aurora My DB. SQL L'istruzione crea file di dati in cui ogni campo è terminato da una virgola (,) e ogni riga è terminata da un carattere di nuova riga (\n) e un file manifest. L'istruzione restituisce un errore se i file che corrispondono al prefisso del file sample_employee_data esistono nel bucket Amazon S3 specificato.

SELECT * FROM employees INTO OUTFILE S3 's3://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    MANIFEST ON;

La seguente istruzione seleziona tutti i dati nella tabella employees e li salva in un bucket Amazon S3 che si trova in una regione diversa dal cluster DB Aurora. L'istruzione crea file di dati in cui ogni campo è terminato da una virgola (,) e ogni riga è terminata da un carattere di nuova riga (\n). L'istruzione sostituisce ogni file che corrisponde al prefisso del file sample_employee_data esistono nel bucket Amazon S3 specificato.

SELECT * FROM employees INTO OUTFILE S3 's3-us-west-2://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    OVERWRITE ON;

L'istruzione seguente seleziona tutti i dati nella employees tabella e li salva in un bucket Amazon S3 che si trova nella stessa regione del cluster Aurora My DB. SQL L'istruzione crea file di dati in cui ogni campo è terminato da una virgola (,) e ogni riga è terminata da un carattere di nuova riga (\n) e un file manifest. L'istruzione sostituisce ogni file che corrisponde al prefisso del file sample_employee_data esistono nel bucket Amazon S3 specificato.

SELECT * FROM employees INTO OUTFILE S3 's3://aurora-select-into-s3-pdx/sample_employee_data'
    FIELDS TERMINATED BY ','
    LINES TERMINATED BY '\n'
    MANIFEST ON
    OVERWRITE ON;