Formats d'URI DBMS_CLOUD

Si vos fichiers sources 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 points d'extrémité dédiés au stockage d'objets. Pour plus d'informations, voir Points d'extrémité dédiés du service de stockage d'objets.

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

Si vos fichiers sources résident dans le service 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 seau 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

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

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

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

Si vos fichiers sources 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 points d'extrémité dédiés au stockage d'objets. Pour plus d'informations, voir Points d'extrémité dédiés du service de stockage d'objets.

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

Si vos fichiers sources résident dans le service 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 pour le fichier channels.txt dans le seau 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

Si vos fichiers sources résident sur le service Oracle Cloud Infrastructure Object Storage, vous pouvez utiliser les URI préauthentifiés d'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, partenaires ou tiers pour accéder à la cible de ressource de stockage d'objets identifiée dans la demande préauthentifiée.

Si vos fichiers sources 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 points d'extrémité dédiés au stockage d'objets. Pour plus d'informations, voir Points d'extrémité dédiés du service de stockage d'objets.

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

Si vos fichiers sources résident dans le service 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 seau bucketname du centre de données Phoenix est :

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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

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 du magasin d'objets Oracle Cloud Infrastructure, sans avoir à créer de données d'identification. Vous devez spécifier le paramètre credential_name en tant que NULL ou ne pas fournir de paramètre credential_name.

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, voir Utilisation des 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 sources résident dans un magasin d'objets qui fournit des URL publiques, vous pouvez utiliser des URL publiques avec des procédures DBMS_CLOUD. Public signifie que le service de stockage d'objets prend en charge l'accès anonyme et non authentifié aux fichiers du magasin d'objets. Consultez votre service de stockage d'objets en nuage pour plus de détails sur la façon de rendre un objet public dans un magasin d'objets pris en charge.

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 magasin d'objets, sans avoir à créer de données d'identification. Vous devez spécifier 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

Voir Compartiments publics pour plus d'informations sur l'utilisation des compartiments publics d'Oracle Cloud Infrastructure.

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

Si vos fichiers sources résident dans le service Stockage d'objets pour Oracle Cloud Infrastructure version classique, reportez-vous à la page REST pour obtenir une description du format d'URI permettant d'accéder à vos fichiers : À propos des URL REST pour les ressources du service de stockage d'objets pour Oracle Cloud Infrastructure version classique.

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

Ces variables de substitution sont des paramètres fictifs 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 base de données IA autonome. Les valeurs propres à l'environnement, telles que l'OCID ou l'espace de noms de la location, ne sont pas codées en dur, ce qui rend votre code SQL dynamique et portable à déployer dans plusieurs régions (pour les API REST OCI).

Voici les avantages liés à l'utilisation de variables de substitution dans les URL OCI :

• Le code SQL est moins sujet aux erreurs car les variables de substitution éliminent la nécessité de fournir des valeurs codées en dur. Ceci est particulièrement utile lors de l'utilisation d'identifiants 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 courante.

• Le basculement inter-région pour une base de données autonome avec intelligence artificielle à l'aide des API REST d'OCI est pratique et moins sujet aux erreurs.

Le tableau suivant répertorie chaque variable de substitution, ainsi que le type de données d'identification pris en charge correspondant et un exemple de valeur :

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

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ûts 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 sources résident dans Amazon S3, consultez la description suivante du format d'URI pour accéder à vos fichiers : Accès à un seau.

Par exemple, ce qui suit fait référence au fichier channels.txt dans le seau 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 du magasin d'objets Amazon S3, sans avoir à créer de données d'identification. Pour utiliser une URL prédéfinie dans une procédure DBMS_CLOUD, spécifiez le paramètre credential_name comme NULL ou n'indiquez pas de paramètre credential_name.

Pour plus d'informations, voir Partager un objet avec d'autres.

Si vos fichiers sources résident dans Azure Blob Storage ou Azure Data Lake Storage, voir la description suivante du format d'URI pour accéder à vos fichiers : Syntaxe de l'URI de la ressource.

Par exemple, ce qui suit 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 mises en oeuvre du service de stockage d'objets qui prennent en charge les URL compatibles avec Amazon S3, notamment les services suivants :

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

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

• URL compatible S3 du service Oracle Cloud Infrastructure Object Storage

  Si vos fichiers sources 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 seau indiqués ci-dessous pour le domaine commercial (OC1). Pour plus d'informations, voir Points d'extrémité dédiés du service de stockage d'objets.

  Note
  
  Les URL de point d'extrémité dédié au magasin d'objets OCI ne sont prises en charge que 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

  • Prise en charge dans toutes les zones :

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

  Formats d'URL de seau :

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

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

  • Prise en charge dans toutes les zones :

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

  Pour plus d'informations, voir Compatibilité avec Amazon S3 et API du service de stockage d'objets.

• URL compatible S3 de Google Cloud Storage

  Format d'URL d'objet :

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

  Format d'URL de seau :

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

  Pour plus d'informations, voir Migration d'Amazon S3 vers Cloud Storage et Points d'extrémité de demande.

• URL compatible Wasabi S3

  Format d'URL d'objet :

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

  Format d'URL de seau :

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

  Pour plus d'informations, voir Informations de référence sur l'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 à partir d'un référentiel GitHub.

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

Par exemple, en utilisant 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, en utilisant 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 de données d'identification avec une visibilité publique des référentiels GitHub. Pour utiliser une URL de visibilité publique, vous pouvez spécifier le paramètre credential_name en tant que NULL ou ne pas fournir de paramètre credential_name. Pour plus d'informations, voir Définition de la visibilité du référentiel.