Esporta dati nell'area di memorizzazione degli oggetti come testo utilizzando DBMS_CLOUD.EXPORT_DATA

Utilizzare DBMS_CLOUD.EXPORT_DATA per esportare i dati come testo da un Autonomous AI Database nell'area di memorizzazione degli oggetti cloud. Le opzioni di esportazione del formato di testo sono CSV, JSON o XML.

Esporta dati JSON in storage degli oggetti cloud

Mostra i passi per esportare i dati della tabella da Autonomous AI Database a Cloud Object Storage come dati JSON specificando una query.

Questo metodo di esportazione supporta tutti gli Object Stores cloud supportati da Autonomous Database ed è possibile utilizzare un principal risorsa di Oracle Cloud Infrastructure per accedere all'area di memorizzazione degli oggetti Oracle Cloud Infrastructure, ai nomi delle risorse Amazon (ARN) per accedere ad AWS Simple Storage Service (S3), a un principal servizio Azure per accedere allo storage BLOB di Azure o a un account servizio Google per accedere alle risorse GCP (Google Cloud Platform).

  1. Connettersi all'istanza di Autonomous AI Database.

    Per ulteriori informazioni, consulta la sezione Connetti ad Autonomous AI Database.

  2. Memorizzare le credenziali dello storage degli oggetti cloud utilizzando DBMS_CLOUD.CREATE_CREDENTIAL.

    Ad esempio:

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    I valori forniti per username e password dipendono dal servizio di storage degli oggetti cloud in uso.

  3. Eseguire DBMS_CLOUD.EXPORT_DATA e specificare il parametro format type con il valore json per esportare i risultati come file JSON nello storage degli oggetti cloud.

    Per generare i file di output JSON, sono disponibili due opzioni per il parametro file_uri_list:

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud.

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud e includere un prefisso del nome file da utilizzare durante la generazione dei nomi file per la notazione JSON esportata.

    Se non si include il prefisso del nome file nel file file_uri_list, DBMS_CLOUD.EXPORT_DATA fornisce un prefisso del nome file. Per informazioni dettagliate, vedere Denominazione file per output di testo (CSV, JSON, Parquet o XML).

    Ad esempio, DBMS_CLOUD.EXPORT_DATA con un prefisso di nome file specificato in file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'json'));
 END;
 /

    In questo esempio, *namespace-string* è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

    Quando i delimitatori di record includono caratteri di escape, ad esempio \r\n o \t, racchiudere i delimitatori di record tra virgolette doppie. Ad esempio, per utilizzare il delimitatore di record \r\n, racchiudere il valore tra apici:"\r\n".

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query => 'SELECT * FROM DEPT',
     format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
 END;
 /

    In questo esempio, *namespace-string* è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

    Per informazioni dettagliate sui parametri, vedere Procedura EXPORT_DATA.

    Per informazioni dettagliate sui parametri format disponibili utilizzabili con DBMS_CLOUD.EXPORT_DATA, vedere DBMS_CLOUD Package Format Options for EXPORT_DATA.

Note per l'esportazione con DBMS_CLOUD.EXPORT_DATA:

Esporta i dati come CSV nello storage degli oggetti cloud

Mostra i passi per esportare i dati delle tabelle da Autonomous AI Database a Cloud Object Storage come dati CSV specificando una query.

Questo metodo di esportazione supporta tutti gli storage degli oggetti cloud supportati da Autonomous AI Database. Puoi anche utilizzare i nomi delle risorse Amazon (ARNs) per accedere ad AWS Simple Storage Service (S3), un principal del servizio Azure per accedere allo storage BLOB di Azure o un account del servizio Google per accedere alle risorse di Google Cloud Platform (GCP).

  1. Connettersi all'istanza di Autonomous AI Database.

    Per ulteriori informazioni, consulta la sezione Connetti ad Autonomous AI Database.

  2. Memorizzare le credenziali dello storage degli oggetti cloud utilizzando DBMS_CLOUD.CREATE_CREDENTIAL.

    Ad esempio:

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    I valori forniti per username e password dipendono dal servizio di storage degli oggetti cloud in uso.

  3. Eseguire DBMS_CLOUD.EXPORT_DATA e specificare il parametro format type con il valore csv per esportare i risultati come file CSV nello storage degli oggetti cloud.

    Per generare i file di output CSV sono disponibili due opzioni per il parametro file_uri_list:

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud.

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud e includere un prefisso del nome file da utilizzare durante la generazione dei nomi file per i file CSV esportati.

    Se non si include il prefisso del nome file nel file file_uri_list, DBMS_CLOUD.EXPORT_DATA fornisce un prefisso del nome file. Per informazioni dettagliate, vedere Denominazione file per output di testo (CSV, JSON, Parquet o XML).

    Ad esempio, DBMS_CLOUD.EXPORT_DATA con un prefisso di nome file specificato in file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip'));
 END;
 /

    In questo esempio, *namespace-string* è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

    Per informazioni dettagliate sui parametri, vedere Procedura EXPORT_DATA.

    Per informazioni dettagliate sui parametri format disponibili utilizzabili con DBMS_CLOUD.EXPORT_DATA, vedere DBMS_CLOUD Package Format Options for EXPORT_DATA.

Note per l'esportazione con DBMS_CLOUD.EXPORT_DATA:

Esportare i dati come parquet nello storage degli oggetti cloud

Mostra i passi per esportare i dati della tabella da Autonomous AI Database a Cloud Object Storage come dati Parquet specificando una query.

Questo metodo di esportazione supporta tutti gli Object Stores cloud supportati da Autonomous Database ed è possibile utilizzare un principal risorsa di Oracle Cloud Infrastructure per accedere all'area di memorizzazione degli oggetti Oracle Cloud Infrastructure, ai nomi delle risorse Amazon (ARN) per accedere ad AWS Simple Storage Service (S3), a un principal servizio Azure per accedere allo storage BLOB di Azure o a un account servizio Google per accedere alle risorse GCP (Google Cloud Platform).

  1. Connettersi all'istanza di Autonomous AI Database.

    Per ulteriori informazioni, consulta la sezione Connetti ad Autonomous AI Database.

  2. Memorizzare le credenziali dello storage degli oggetti cloud utilizzando DBMS_CLOUD.CREATE_CREDENTIAL.

    Ad esempio:

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    I valori forniti per username e password dipendono dal servizio di storage degli oggetti cloud in uso.

  3. Eseguire DBMS_CLOUD.EXPORT_DATA e specificare il parametro format type con il valore parquet per esportare i risultati come file parquet nello storage degli oggetti cloud.

    Per generare i file di output del parquet sono disponibili due opzioni per il parametro file_uri_list:

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud.

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud e includere un prefisso del nome file da utilizzare durante la generazione dei nomi file per i file parquet esportati.

    Se non si include il prefisso del nome file nel file file_uri_list, DBMS_CLOUD.EXPORT_DATA fornisce un prefisso del nome file. Per informazioni dettagliate, vedere Denominazione file per output di testo (CSV, JSON, Parquet o XML).

    Ad esempio, DBMS_CLOUD.EXPORT_DATA con un prefisso di nome file specificato in file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'parquet', 'compression' value 'snappy'));
 END;
 /

    In questo esempio, *namespace-string* è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

    Per informazioni dettagliate sui parametri, vedere Procedura EXPORT_DATA.

    Per informazioni dettagliate sui parametri format disponibili utilizzabili con DBMS_CLOUD.EXPORT_DATA, vedere DBMS_CLOUD Package Format Options for EXPORT_DATA.

Note per l'esportazione con DBMS_CLOUD.EXPORT_DATA:

Esporta dati come XML nello storage degli oggetti cloud

Mostra i passi per esportare i dati della tabella da Autonomous AI Database a Cloud Object Storage come dati XML specificando una query.

Questo metodo di esportazione supporta tutti gli storage degli oggetti cloud supportati da Autonomous AI Database. Puoi anche utilizzare i nomi delle risorse Amazon (ARNs) per accedere ad AWS Simple Storage Service (S3), un principal del servizio Azure per accedere allo storage BLOB di Azure o un account del servizio Google per accedere alle risorse di Google Cloud Platform (GCP).

  1. Connettersi all'istanza di Autonomous AI Database.

    Per ulteriori informazioni, consulta la sezione Connetti ad Autonomous AI Database.

  2. Memorizzare le credenziali dello storage degli oggetti cloud utilizzando DBMS_CLOUD.CREATE_CREDENTIAL.

    Ad esempio:

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    I valori forniti per username e password dipendono dal servizio di storage degli oggetti cloud in uso.

  3. Eseguire DBMS_CLOUD.EXPORT_DATA e specificare il parametro format type con il valore xml per esportare i risultati come file XML nello storage degli oggetti cloud.

    Per generare i file di output XML sono disponibili due opzioni per il parametro file_uri_list:

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud.

    • Impostare il valore file_uri_list sull'URL per un bucket esistente nello storage degli oggetti cloud e includere un prefisso del nome file da utilizzare durante la generazione dei nomi file per la notazione JSON esportata.

    Se non si include il prefisso del nome file nel file file_uri_list, DBMS_CLOUD.EXPORT_DATA fornisce un prefisso del nome file. Per informazioni dettagliate, vedere Denominazione file per output di testo (CSV, JSON, Parquet o XML).

    Ad esempio, DBMS_CLOUD.EXPORT_DATA con un prefisso di nome file specificato in file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'xml', 'compression' value 'gzip'));
 END;
 /

    In questo esempio, *namespace-string* è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

    Per informazioni dettagliate sui parametri, vedere Procedura EXPORT_DATA.

    Per informazioni dettagliate sui parametri format disponibili utilizzabili con DBMS_CLOUD.EXPORT_DATA, vedere DBMS_CLOUD Package Format Options for EXPORT_DATA.

Note per l'esportazione con DBMS_CLOUD.EXPORT_DATA:

Denominazione file per output di testo ( CSV, JSON, Parquet o XML)

Descrive la denominazione del file di output utilizzando DBMS_CLOUD.EXPORT_DATA con output file di testo CSV, JSON, Parquet o XML.

DBMS_CLOUD.EXPORT_DATA esegue la query specificata con il parametro query e invia i risultati a file di testo nel bucket dell'area di memorizzazione degli oggetti cloud o a una directory. Il formato di output dipende dal parametro format type specificato (uno di CSV, JSON, Parquet o XML).

Per velocizzare la procedura e generare l'output il più velocemente possibile, DBMS_CLOUD.EXPORT_DATA divide il suo lavoro. Ciò significa che, a seconda delle risorse di sistema, quando si esegue DBMS_CLOUD.EXPORT_DATA, la procedura crea più file di output nel bucket dell'area di memorizzazione degli oggetti cloud o nella directory.

Il formato per ogni file generato è:

[FileNamePrefix | client_info_module_action]_sequenceNum_timestamp.format_extension.[compression_extension]

Ad esempio, il prefisso del nome file nella procedura DBMS_CLOUD.EXPORT_DATA seguente è specificato nel parametro file_uri_list, come dept_export. L'esempio genera l'output nell'area di memorizzazione degli oggetti fornita nel formato specificato.

BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
    query           => 'SELECT * FROM DEPT',
    format          => JSON_OBJECT('type' value 'json'));
END;
/

Quando si specifica il prefisso di un nome file, i file di output generati includono il prefisso del nome file, simile al seguente:

dept_export_1_20210809T173033Z.json
dept_export_2_20210809T173034Z.json
dept_export_3_20210809T173041Z.json
dept_export_4_20210809T173035Z.json

Il numero di file di output generati dipende dalla dimensione dei risultati, dal servizio di database e dal numero di ECPU (OCPU se il database utilizza OCPU) nell'istanza di Autonomous AI Database.

Nell'esempio seguente il parametro file_uri_list non include un prefisso nome file e viene fornito il parametro compression, con valore gzip:

BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/',
    query           => 'SELECT * FROM DEPT',
    format          => json_object('type' value 'json', 'compression' value 'gzip'));
END;
/

Quando il prefisso del nome di un file non si trova nel parametro file_uri_list, DBMS_CLOUD.EXPORT_DATA utilizza un prefisso del nome file nel formato client_info_module_action. Per questo esempio i file di output generati includono il prefisso del nome file fornito da DBMS_CLOUD.EXPORT_DATA e i file vengono compressi con gzip e viene aggiunta l'estensione file .gz, come indicato di seguito.

Client1_Module1_Action1_1_20210809T173033Z.json.gz
Client1_Module1_Action1_2_20210809T173034Z.json.gz
Client1_Module1_Action1_3_20210809T173041Z.json.gz
Client1_Module1_Action1_4_20210809T173035Z.json.gz

Se le informazioni sulla sessione client_info_module_action non sono disponibili quando si esegue DBMS_CLOUD.EXPORT_DATA, il prefisso del nome file viene impostato su data. Ad esempio:

data_1_20210809T173033Z.json.gz
data_2_20210809T173034Z.json.gz
data_3_20210809T173041Z.json.gz
data_4_20210809T173035Z.json.gz

Ad esempio, il prefisso del nome file nella procedura DBMS_CLOUD.EXPORT_DATA seguente è specificato nel parametro file_uri_list, come dept_export. L'esempio genera l'output nella directory specificata nel formato specificato.

BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    file_uri_list   => 'DATA_PUMP_DIR:sales.json',
    query           => 'SELECT * FROM SALES',
    format          => JSON_OBJECT('type' value 'json'));
END;
/

Quando si specifica un prefisso di nome file, il file di output generato include il prefisso del nome file, simile al seguente:

sales_1_20230705T124523275915Z.csv

Note per la denominazione dei file con DBMS_CLOUD.EXPORT_DATA:

Contenuto correlato