Formats d'URI DBMS_CLOUD

Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage dans le domaine commercial (OC1), il est recommandé d'utiliser le format d'URI suivant qui utilise des adresses dédiées Object Storage. Pour plus d'informations, reportez-vous à Adresses dédiées Object Storage.

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

Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage et ne se trouvent pas dans le domaine commercial (OC1), vous devez utiliser le format suivant :

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

Par exemple, dans le domaine commercial (OC1), l'URI natif du fichier channels.txt dans le bucket bucketname du centre de données Phoenix est :

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

Dans cet exemple, namespace-string est l'espace de noms d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

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

Vous pouvez trouver l'URI dans les détails d'objet d'Oracle Cloud Infrastructure Object Storage dans le menu de points de suspension de droite de la banque d'objets :

1. Ouvrez la console Oracle Cloud Infrastructure en cliquant sur en regard d'Oracle Cloud.
2. Dans le menu de navigation de gauche d'Oracle Cloud Infrastructure, cliquez sur Infrastructure de base. Sous Object Storage, cliquez sur Object Storage.
3. Sous Portée de la liste, sélectionnez un compartiment.
4. Dans la colonne Nom, sélectionnez un bucket.
5. Dans la zone Objets, cliquez sur Afficher les détails de l'objet.
   
   Description de l'illustration ad_oci_view_object_details.png
6. Sur la page Détails de l'objet, le champ Chemin d'URL (URI) affiche l'URI permettant d'accéder à l'objet.

Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage dans le domaine commercial (OC1), il est recommandé d'utiliser le format d'URI suivant qui utilise des adresses dédiées Object Storage. Pour plus d'informations, reportez-vous à Adresses dédiées Object Storage.

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

Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage et ne se trouvent pas dans le domaine commercial (OC1), vous devez utiliser le format suivant :

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

Par exemple, dans le domaine commercial (OC1), l'URI Swift du fichier channels.txt dans le bucket bucketname du centre de données Phoenix est :

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

Dans cet exemple, namespace-string est l'espace de noms d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

Si vos fichiers source résident dans Oracle Cloud Infrastructure Object Storage, vous pouvez utiliser des URI pré-authentifiés Oracle Cloud Infrastructure. Lorsque vous créez une demande pré-authentifiée, une URL unique est générée. Vous pouvez ensuite fournir l'URL unique aux utilisateurs de votre organisation, de vos partenaires ou de tiers pour accéder à la cible de ressource Object Storage identifiée dans la demande pré-authentifiée.

Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage dans le domaine commercial (OC1), il est recommandé d'utiliser le format d'URI suivant qui utilise des adresses dédiées Object Storage. Pour plus d'informations, reportez-vous à Adresses dédiées Object Storage.

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

Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage et ne se trouvent pas dans le domaine commercial (OC1), vous devez utiliser le format suivant :

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

Par exemple, dans le domaine commercial (OC1), un exemple d'URI pré-authentifié pour le fichier channels.txt dans le bucket bucketname du centre de données Phoenix est le suivant :

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

Dans cet exemple, namespace-string est l'espace de noms d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

Vous pouvez utiliser une URL pré-authentifiée dans n'importe quelle procédure DBMS_CLOUD qui utilise une URL pour accéder aux fichiers de la banque d'objets Oracle Cloud Infrastructure, sans avoir à créer d'informations d'identification. Vous devez indiquer le paramètre credential_name en tant que NULL ou ne pas fournir de paramètre credential_name.

Par exemple :

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;
/

Pour plus d'informations, reportez-vous à Utilisation de demandes pré-authentifiées.

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

Si vos fichiers source résident dans une banque d'objets qui fournit des URL publiques, vous pouvez utiliser des URL publiques avec des procédures DBMS_CLOUD. Public signifie que le service Object Storage prend en charge l'accès anonyme et non authentifié aux fichiers de la banque d'objets. Pour plus de détails sur la manière de rendre un objet public dans une banque d'objets prise en charge, reportez-vous à votre service Cloud Object Storage.

Vous pouvez utiliser une URL publique dans n'importe quelle procédure DBMS_CLOUD qui utilise une URL pour accéder aux fichiers de votre banque d'objets, sans avoir à créer d'informations d'identification. Vous devez indiquer le paramètre credential_name en tant que NULL ou ne pas fournir de paramètre credential_name.

Par exemple, la commande suivante utilise DBMS_CLOUD.COPY_DATA sans 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;
/

Dans cet exemple, namespace-string est l'espace de noms d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

Pour plus d'informations sur l'utilisation des buckets publics Oracle Cloud Infrastructure, reportez-vous à Buckets publics.

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

Si les fichiers source résident dans Oracle Cloud Infrastructure Object Storage Classic, reportez-vous à la page REST pour obtenir la description du format d'URI permettant d'accéder à vos fichiers : A propos des URL REST pour les ressources Oracle Cloud Infrastructure Object Storage Classic.

Vous pouvez fournir des variables de substitution prédéfinies dans vos URL Oracle Cloud Infrastructure (OCI) lorsque vous fournissez l'URI du paramètre object_uri pour les procédures et fonctions DBMS_CLOUD.

Ces variables de substitution sont des espaces réservés prédéfinis, tels que my$home_region et my$tenancy, qui sont résolus et remplacés par les valeurs réelles correspondantes en fonction du contexte d'exécution de votre instance Autonomous Database. Les valeurs propres à l'environnement, telles que l'OCID ou l'espace de noms de location, ne sont pas codées en dur, ce qui rend le code SQL dynamique et portable à déployer dans plusieurs régions (pour les API REST OCI).

Les avantages de l'utilisation de variables de substitution dans les URL OCI sont les suivants :

• Le code SQL est moins sujet aux erreurs car les variables de substitution évitent de fournir des valeurs codées en dur. Ceci est particulièrement utile lorsque vous utilisez des identificateurs longs.

• Le code SQL est portable et n'est pas propre à une région ou à un environnement. Le même code SQL peut être réutilisé et déployé dans plusieurs régions pour les API REST OCI sans avoir à identifier la région en cours.

• Le basculement inter-région pour Autonomous Database à l'aide des API REST OCI est pratique et moins sujet aux erreurs.

La liste des espaces réservés pris en charge est la suivante :

• my$home_region : indique la région d'origine de la location Oracle Cloud Infrastructure (OCI).

  La variable de substitution my$home_region est uniquement prise en charge avec les types d'informations d'identification suivants :

  • Clé de signature d'API OCI

  • Principal de ressources OCI

• my$region : indique la région Oracle Cloud Infrastructure (OCI) de votre instance Autonomous Database.

  La variable de substitution my$region est uniquement prise en charge avec les types d'informations d'identification suivants :

  • Clé de signature d'API OCI

  • Principal de ressources OCI

  • Jeton d'authentification/informations d'identification Swift

• my$cloud_domain : indique le nom de domaine Oracle Cloud Infrastructure (OCI) pour votre instance Oracle Cloud Infrastructure (OCI).

  La variable de substitution my$cloud_domain est uniquement prise en charge avec les types d'informations d'identification suivants :

  • Clé de signature d'API OCI

  • Principal de ressources OCI

  • Jeton d'authentification/informations d'identification Swift

• my$namespace : indique l'espace de noms Oracle Cloud Infrastructure (OCI) Object Storage.

  La variable de substitution my$namespace est uniquement prise en charge avec les types d'informations d'identification suivants :

  • Clé de signature d'API OCI

  • Principal de ressources OCI

• my$compartment : indique l'OCID du compartiment.

  La variable de substitution my$compartment est uniquement prise en charge avec les types d'informations d'identification suivants :

  • Clé de signature d'API OCI

  • Principal de ressources OCI

  • Jeton d'authentification/informations d'identification Swift

• my$tenancy : indique l'OCID de votre location.

  La variable de substitution my$tenancy est uniquement prise en charge avec les types d'informations d'identification suivants :

  • Clé de signature d'API OCI

  • Principal de ressources OCI

  • Jeton d'authentification/informations d'identification Swift

Exemple d'utilisation de variables de substitution prédéfinies pour accéder à un fichier Object Storage :

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;

Exemple d'utilisation de variables de substitution prédéfinies pour accéder au fichier de rapport de coût 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;

Si vos fichiers source résident dans Amazon S3, reportez-vous à la section suivante pour une description du format d'URI permettant d'accéder à vos fichiers : Accès à un bucket.

Par exemple, les éléments suivants font référence au fichier channels.txt dans le bucket adb de la région us-west-2.

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

Vous pouvez utiliser une URL prédéfinie dans n'importe quelle procédure DBMS_CLOUD qui utilise une URL pour accéder aux fichiers de la banque d'objets Amazon S3, sans avoir à créer d'informations d'identification. Pour utiliser une URL prédéfinie dans une procédure DBMS_CLOUD, indiquez le paramètre credential_name en tant que NULL ou ne fournissez pas de paramètre credential_name.

Pour plus d'informations, reportez-vous à Partage d'un objet avec d'autres.

Si vos fichiers source résident dans Azure Blob Storage ou Azure Data Lake Storage, reportez-vous à la section suivante pour obtenir une description du format d'URI permettant d'accéder à vos fichiers : Syntaxe d'URI de ressource.

Par exemple, le terme suivant fait référence au fichier channels.txt dans le conteneur adb du compte de stockage adb_user :

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

DBMS_CLOUD prend en charge les implémentations de service de stockage d'objets qui prennent en charge les URL compatibles Amazon S3, y compris les services suivants :

• URL compatible Oracle Cloud Infrastructure Object Storage avec Amazon S3
• Google Cloud Storage avec URL compatible Amazon S3
• Stockage Hot Cloud Wasabi avec URL compatible Amazon S3

Si vos fichiers source résident sur un service qui prend en charge les URI compatibles Amazon S3, utilisez le format d'URI suivant pour accéder à vos fichiers :

• URL compatible S3 Oracle Cloud Infrastructure Object Storage

  Si vos fichiers source résident sur Oracle Cloud Infrastructure Object Storage dans le domaine commercial (OC1), il est recommandé d'utiliser les formats d'URL d'objet et d'URL de bucket répertoriés ci-dessous pour le domaine commercial (OC1). Pour plus d'informations, reportez-vous à Adresses dédiées Object Storage.

  Remarque
  
  Les URL d'adresse dédiées de la banque d'objets OCI sont uniquement prises en charge dans les domaines commerciaux (OC1).

  Formats d'URL d'objet

  • Pris en charge uniquement dans le domaine commercial (OC1) :

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

  • Pris en charge dans toutes les zones :

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

  Formats d'URL de bucket :

  • Pris en charge uniquement dans le domaine commercial (OC1) :

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

  • Pris en charge dans toutes les zones :

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

  Pour plus d'informations, reportez-vous à Compatibilité Amazon S3 et à API Object Storage Service.

• URL compatible Google Cloud Storage S3

  Format d'URL d'objet :

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

  Format d'URL de bucket :

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

  Pour plus d'informations, reportez-vous à Migration d'Amazon S3 vers le stockage cloud et à Demande d'adresses.

• URL compatible Wasabi S3

  Format d'URL d'objet :

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

  Format d'URL de bucket :

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

  Pour plus d'informations, reportez-vous à Référence d'API Wasabi S3 et à URL de service pour les régions de stockage de Wasabi.

DBMS_CLOUD prend en charge les URL brutes GitHub pour accéder aux données d'un référentiel GitHub.

Utilisez les URL brutes GitHub avec les API DBMS_CLOUD pour accéder aux fichiers source qui résident dans un référentiel GitHub. Lorsque vous accédez à un fichier sur GitHub et que vous cliquez sur le lien Raw, l'URL brute GitHub apparaît. Le domaine raw.githubusercontent.com fournit des versions non traitées des fichiers stockés dans les référentiels GitHub.

Par exemple, utilisez 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;
/

Par exemple, utilisez 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;

Les procédures DBMS_CLOUD qui utilisent une URL pour accéder à un référentiel GitHub ne nécessitent pas d'informations d'identification avec des référentiels GitHub de visibilité publique. Pour utiliser une URL de visibilité publique, vous pouvez indiquer le paramètre credential_name en tant que NULL ou ne pas fournir de paramètre credential_name. Pour plus d'informations, reportez-vous à Définition de la visibilité du référentiel.