Formati URI DBMS_CLOUD

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage nel realm commerciale (OC1), si consiglia di utilizzare il formato URI seguente che utilizza gli endpoint dedicati dello storage degli oggetti. Per ulteriori informazioni, vedere Endpoint dedicati dello storage degli oggetti.

https://namespace-string.objectstorage.region.oci.customer-oci.com/n/namespace-string/b/bucketname/o/filename

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage e non si trovano nel realm commerciale (OC1), è necessario utilizzare il seguente formato:

https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o/filename

Ad esempio, nel realm commerciale (OC1) l'URI nativo per il file channels.txt nel bucket bucketname nel data center Phoenix è:

https://namespace.objectstorage.region.oci.customer-oci.com/n/namespace/b/bucketname/o/channels.txt

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.

object_uri => 'https://objectstorage.my$region.my$cloud_domain/n/my$namespace/b/bucket_name/o/file_name'

Puoi trovare l'URI da "Dettagli oggetto" di Oracle Cloud Infrastructure Object Storage nel menu con i puntini di sospensione del lato destro nell'area di memorizzazione degli oggetti:

1. Apri la console di Oracle Cloud Infrastructure facendo clic sul accanto a Oracle Cloud.
2. Dal menu di navigazione a sinistra di Oracle Cloud Infrastructure fai clic su Infrastruttura di base. In Storage degli oggetti fare clic su Storage degli oggetti.
3. In Ambito lista selezionare un Compartimento.
4. Nella colonna Nome selezionare un bucket.
5. Nell'area Oggetti fare clic su Visualizza dettagli oggetto.
   
   Descrizione dell'immagine ad_oci_view_object_details.png
6. Nella pagina Dettagli oggetto, il campo Percorso URL (URI) mostra l'URI per accedere all'oggetto.

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage nel realm commerciale (OC1), si consiglia di utilizzare il formato URI seguente che utilizza gli endpoint dedicati dello storage degli oggetti. Per ulteriori informazioni, vedere Endpoint dedicati dello storage degli oggetti.

https://namespace-string.swiftobjectstorage.region.oci.customer-oci.com/v1/namespace-string/bucket/filename

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage e non si trovano nel realm commerciale (OC1), è necessario utilizzare il seguente formato:

https://swiftobjectstorage.region.oraclecloud.com/v1/namespace-string/bucket/filename

Ad esempio, nel realm commerciale (OC1) l'URI Swift per il file channels.txt nel bucket bucketname nel data center Phoenix è:

https://namespace-string.swiftobjectstorage.us-phoenix-1.oci.customer-oci.com/v1/namespace-string/bucketname/channels.txt

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.

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage, puoi utilizzare gli URI preautenticati di Oracle Cloud Infrastructure. Quando si crea una richiesta preautenticata, viene generato un URL univoco. Puoi quindi fornire l'URL univoco agli utenti dell'organizzazione, dei partner o di terze parti per accedere alla destinazione delle risorse di storage degli oggetti identificata nella richiesta preautenticata.

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage nel realm commerciale (OC1), si consiglia di utilizzare il formato URI seguente che utilizza gli endpoint dedicati dello storage degli oggetti. Per ulteriori informazioni, vedere Endpoint dedicati dello storage degli oggetti.

https://namespace-string.objectstorage.region.oci.customer-oci.com/p/encrypted_string/n/namespace-string/b/bucket/o/filename

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage e non si trovano nel realm commerciale (OC1), è necessario utilizzare il seguente formato:

https://objectstorage.region.oraclecloud.com.com/p/encrypted_string/n/namespace-string/b/bucket/o/filename

Ad esempio, nel realm commerciale (OC1) un URI preautenticato di esempio per il file channels.txt nel bucket nome bucket nel data center Phoenix è:

https://namespace-string.objectstorage.us-phoenix-1.oci.customer-oci.com/p/2xN-uDtWJNsiD910UCYGue/n/namespace-string/b/bucketname/o/channels.txt

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.

È possibile utilizzare un URL preautenticato in qualsiasi procedura DBMS_CLOUD che richiede un URL per accedere ai file nell'area di memorizzazione degli oggetti di Oracle Cloud Infrastructure, senza dover creare una credenziale. Specificare il parametro credential_name come NULL oppure non fornire un parametro credential_name.

Ad esempio:

BEGIN
  DBMS_CLOUD.COPY_DATA(
     table_name =>'CHANNELS',
     file_uri_list =>'https://objectstorage.us-phoenix-1.oraclecloud.com/p/unique-pre-authenticated-string/n/namespace-string/b/bucketname/o/channels.txt',
     format => json_object('delimiter' value ',') );
END;
/

Per ulteriori informazioni, vedere Utilizzo delle richieste preautenticate.

object_uri => 'https://objectstorage.my$region.my$cloud_domain/n/my$namespace/b/bucket_name/o/file_name'

Se i file di origine risiedono in un'area di memorizzazione degli oggetti che fornisce URL pubblici, è possibile utilizzare URL pubblici con le procedure DBMS_CLOUD. Pubblico indica che il servizio di storage degli oggetti supporta l'accesso anonimo e non autenticato ai file dell'area di memorizzazione degli oggetti. Consulta il servizio di storage degli oggetti cloud per i dettagli su come rendere pubblico un oggetto in un'area di memorizzazione degli oggetti supportata.

È possibile utilizzare un URL pubblico in qualsiasi procedura DBMS_CLOUD che richiede un URL per accedere ai file nell'area di memorizzazione degli oggetti, senza la necessità di creare una credenziale. Specificare il parametro credential_name come NULL oppure non fornire un parametro credential_name.

Ad esempio, si utilizza DBMS_CLOUD.COPY_DATA senza credential_name:

BEGIN
  DBMS_CLOUD.COPY_DATA(
     table_name =>'CHANNELS',
     file_uri_list =>'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucketname/o/chan_v3.dat',
     format => json_object('delimiter' value ',') );
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.

Consulta i bucket pubblici per informazioni sull'uso dei bucket pubblici di Oracle Cloud Infrastructure.

object_uri => 'https://objectstorage.my$region.my$cloud_domain/n/my$namespace/b/bucket_name/o/file_name'

Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage Classic, vedere la pagina REST per una descrizione del formato URI per l'accesso ai file: Informazioni sugli URL REST per le risorse di Oracle Cloud Infrastructure Object Storage Classic.

È possibile fornire variabili di sostituzione predefinite negli URL OCI (Oracle Cloud Infrastructure) quando si fornisce l'URI per il parametro object_uri per le procedure e le funzioni DBMS_CLOUD.

Queste variabili di sostituzione sono segnaposto predefiniti, ad esempio my$home_region e my$tenancy, che vengono risolti e sostituiti con i valori effettivi corrispondenti in base al contesto di runtime dell'Autonomous Database. I valori specifici dell'ambiente, come l'OCID della tenancy o lo spazio di nomi, non sono di tipo hard coded, rendendo il codice SQL dinamico e portatile da distribuire in più aree (per le API REST OCI).

Di seguito sono riportati i vantaggi derivanti dall'uso delle variabili di sostituzione negli URL OCI.

• Il codice SQL è meno soggetto a errori perché le variabili di sostituzione eliminano la necessità di fornire valori non modificabili. Questo è particolarmente utile quando si utilizzano identificatori lunghi.

• Il codice SQL è portatile e non specifico dell'area o dell'ambiente. Lo stesso codice SQL può essere riutilizzato e distribuito in più aree per le API REST OCI senza dover identificare l'area corrente.

• Il failover tra più aree per Autonomous Database che utilizza le API REST OCI è comodo e meno soggetto a errori.

Di seguito è riportato l'elenco dei segnaposto supportati:

• my$home_region: specifica l'area di origine della tenancy Oracle Cloud Infrastructure (OCI).

  La variabile di sostituzione my$home_region è supportata solo con i seguenti tipi di credenziali:

  • Chiave di firma API OCI

  • Principal risorse OCI

• my$region: specifica l'area Oracle Cloud Infrastructure (OCI) dell'Autonomous Database.

  La variabile di sostituzione my$region è supportata solo con i seguenti tipi di credenziali:

  • Chiave di firma API OCI

  • Principal risorse OCI

  • Token di autenticazione/credenziale di spostamento

• my$cloud_domain: specifica il nome di dominio di Oracle Cloud Infrastructure (OCI) per Oracle Cloud Infrastructure (OCI).

  La variabile di sostituzione my$cloud_domain è supportata solo con i seguenti tipi di credenziali:

  • Chiave di firma API OCI

  • Principal risorse OCI

  • Token di autenticazione/credenziale di spostamento

• my$namespace: specifica lo spazio di nomi di Oracle Cloud Infrastructure (OCI) Object Storage.

  La variabile di sostituzione my$namespace è supportata solo con i seguenti tipi di credenziali:

  • Chiave di firma API OCI

  • Principal risorse OCI

• my$compartment: specifica l'OCID del compartimento.

  La variabile di sostituzione my$compartment è supportata solo con i seguenti tipi di credenziali:

  • Chiave di firma API OCI

  • Principal risorse OCI

  • Token di autenticazione/credenziale di spostamento

• my$tenancy: specifica l'OCID della tenancy.

  La variabile di sostituzione my$tenancy è supportata solo con i seguenti tipi di credenziali:

  • Chiave di firma API OCI

  • Principal risorse OCI

  • Token di autenticazione/credenziale di spostamento

Esempio di utilizzo di variabili di sostituzione predefinite per accedere a un file di storage degli oggetti:

SELECT TO_CLOB(DBMS_CLOUD.GET_OBJECT (
    credential_name => credential_name,
    object_uri      => 'https://objectstorage.my$region.my$cloud_domain/n/my$namespace/b/bucket_name/o/file_name'))
FROM DUAL;

Esempio di utilizzo di variabili di sostituzione predefinite per accedere al file dei report sui costi OCI:

SELECT TO_CLOB(DBMS_CLOUD.GET_OBJECT (
    credential_name => credential_name,
    object_uri      => 'https://objectstorage.my$home_region.my$cloud_domain/n/namespace-string/b/my$tenancy/o/reports/cost-csv/file_name.csv.gz',
    compression     => DBMS_CLOUD.COMPRESS_GZIP))
FROM DUAL;

Se i file di origine risiedono in Amazon S3, vedere quanto segue per una descrizione del formato URI per l'accesso ai file: Accesso a un bucket.

Ad esempio, quanto riportato di seguito fa riferimento al file channels.txt nel bucket adb nell'area us-west-2.

https://s3-us-west-2.amazonaws.com/adb/channels.txt 

È possibile utilizzare un URL preselezionato in qualsiasi procedura DBMS_CLOUD che richiede un URL per accedere ai file nell'area di memorizzazione degli oggetti Amazon S3, senza la necessità di creare una credenziale. Per utilizzare un URL predefinito in qualsiasi procedura DBMS_CLOUD, specificare il parametro credential_name come NULL oppure non fornire un parametro credential_name.

Per ulteriori informazioni, vedere Condividi un oggetto con altri.

Se i file di origine risiedono in Azure Blob Storage o Azure Data Lake Storage, vedere quanto segue per una descrizione del formato URI per l'accesso ai file: Sintassi URI risorsa.

Ad esempio, quanto riportato di seguito fa riferimento al file channels.txt nel contenitore adb nell'account di storage adb_user:

https://adb_user.blob.core.windows.net/adb/channels.txt

DBMS_CLOUD supporta implementazioni di servizi di storage degli oggetti che supportano gli URL compatibili con Amazon S3, inclusi i seguenti servizi:

• Oracle Cloud Infrastructure Object Storage con URL compatibile con Amazon S3
• Google Cloud Storage con URL compatibile con Amazon S3
• Wasabi Hot Cloud Storage con URL compatibile con Amazon S3

Se i file sorgente risiedono in un servizio che supporta URI compatibili con Amazon S3, utilizzare il seguente formato URI per accedere ai file:

• URL compatibile di Oracle Cloud Infrastructure Object Storage S3

  Se i file di origine risiedono in Oracle Cloud Infrastructure Object Storage nel realm commerciale (OC1), si consiglia di utilizzare i formati URL oggetto e URL bucket elencati di seguito per il realm commerciale (OC1). Per ulteriori informazioni, vedere Endpoint dedicati dello storage degli oggetti.

  Nota
  
  Gli URL degli endpoint dedicati di OCI Object Store sono supportati solo nei realm commerciali (OC1).

  Formati URL oggetto

  • Supportato solo nel realm commerciale (OC1):

    https://mynamespace.compat.objectstorage.region.oci.customer-oci.com/bucket_name/object_name

  • Supportato in tutte le zone:

    https://mynamespace.compat.objectstorage.region.oraclecloud.com/bucket_name/object_name

  Formati URL bucket:

  • Supportato solo nel realm commerciale (OC1):

    https://mynamespace.compat.objectstorage.region.oci.customer-oci.com/bucket_name

  • Supportato in tutte le zone:

    https://mynamespace.compat.objectstorage.region.oraclecloud.com/bucket_name

  Per ulteriori informazioni, consulta le sezioni relative alla compatibilità di Amazon S3 e all'API del servizio di storage degli oggetti.

• URL compatibile con Google Cloud Storage S3

  Formato URL oggetto:

  https://bucketname.storage.googleapis.com/object_name

  Formato URL bucket:

  https://bucketname.storage.googleapis.com/

  Per ulteriori informazioni, consulta la sezione relativa alla migrazione da Amazon S3 allo storage cloud e agli endpoint delle richieste.

• URL compatibile con Wasabi S3

  Formato URL oggetto:

  https://bucketname.s3.region.wasabisys.com/object_name

  Formato URL bucket:

  https://bucketname.s3.region.wasabisys.com/

  Per ulteriori informazioni, consulta Wasabi S3 API Reference e URL di servizio per le aree di storage di Wasabi.

DBMS_CLOUD supporta gli URL raw GitHub per accedere ai dati da un repository GitHub.

Utilizzare URL raw GitHub con API DBMS_CLOUD per accedere ai file di origine che risiedono in un repository GitHub. Quando si passa a un file in GitHub e si fa clic sul collegamento Raw, viene visualizzato l'URL raw GitHub. Il dominio raw.githubusercontent.com fornisce versioni non elaborate dei file memorizzati nei repository GitHub.

Ad esempio, utilizzando DBMS_CLOUD.GET_OBJECT:

BEGIN
 DBMS_CLOUD.GET_OBJECT(
   credential_name => 'MY_CRED',
   object_uri      => 'https://raw.githubusercontent.com/myaccount/myrepo/master/data-management-library/autonomous-database/adb-loading.csv',
   directory_name  => 'DATA_PUMP_DIR'
  );
END;
/

Ad esempio, utilizzando DBMS_CLOUD.CREATE_EXTERNAL_TABLE:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_TABLE(
    credential_name => 'MY_CRED',
    table_name      => 'EMPLOYEES_EXT',
    file_uri_list   => 'https://raw.githubusercontent.com/myaccount/myrepo/master/data-management-library/autonomous-database/*.csv',
    column_list     => 'name varchar2(30), gender varchar2(30), salary number',
    format          => JSON_OBJECT('type' value 'csv')
  );
END;
/
SELECT * FROM employees_ext;

Le procedure DBMS_CLOUD che utilizzano un URL per accedere a un repository GitHub non richiedono credenziali con repository GitHub di visibilità pubblica. Per utilizzare un URL di visibilità pubblico, è possibile specificare il parametro credential_name come NULL o non fornire un parametro credential_name. Per ulteriori informazioni, vedere Impostazione della visibilità del repository.