ソース・ファイルが商用レルム(OC1)のOracle Cloud Infrastructure Object Storageに存在する場合は、オブジェクト・ストレージ専用エンドポイントを使用する次のURI形式を使用することをお薦めします。詳細は、オブジェクト・ストレージ専用エンドポイントを参照してください。

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

ソース・ファイルがOracle Cloud Infrastructure Object Storageにあり、商用レルム(OC1)にない場合は、次の形式を使用する必要があります。

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

たとえば、商用レルム(OC1)では、Phoenixデータ・センターのbucketnameバケット内にあるファイルchannels.txtのネイティブURIは次のとおりです:

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

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

URIは、オブジェクト・ストアの右側の省略記号メニューにあるOracle Cloud Infrastructure Object Storageの「オブジェクトの詳細」にあります:

1. Oracle Cloudの横にあるをクリックして、Oracle Cloud Infrastructureコンソールを開きます。
2. Oracle Cloud Infrastructureの左側のナビゲーション・メニューから、「コア・インフラストラクチャ」をクリックします。「Object Storage」の下で、「Object Storage」をクリックします。
3. 「リスト範囲」の下で、「コンパートメント」を選択します。
4. 「名前」列からバケットを選択します。
5. 「オブジェクト」領域で、「オブジェクト詳細の表示」をクリックします。
   
   
6. 「オブジェクトの詳細」ページのURLパス(URI)フィールドに、オブジェクトにアクセスするためのURIが表示されます。

ソース・ファイルが商用レルム(OC1)のOracle Cloud Infrastructure Object Storageに存在する場合は、オブジェクト・ストレージ専用エンドポイントを使用する次のURI形式を使用することをお薦めします。詳細は、オブジェクト・ストレージ専用エンドポイントを参照してください。

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

ソース・ファイルがOracle Cloud Infrastructure Object Storageにあり、商用レルム(OC1)にない場合は、次の形式を使用する必要があります。

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

たとえば、商用レルム(OC1)では、Phoenixデータ・センターのbucketnameバケット内にあるファイルchannels.txtのSwift URIは次のとおりです:

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

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

ソース・ファイルがOracle Cloud Infrastructure Object Storageにある場合は、Oracle Cloud Infrastructureの事前認証済URIを使用できます。事前認証済リクエストの作成時に、一意のURLが生成されます。この一意のURLを組織内のユーザー、パートナまたはサードパーティに提供すると、事前認証済リクエストで識別されたオブジェクト・ストレージ・リソース・ターゲットにアクセスできるようになります。

ソース・ファイルが商用レルム(OC1)のOracle Cloud Infrastructure Object Storageに存在する場合は、オブジェクト・ストレージ専用エンドポイントを使用する次のURI形式を使用することをお薦めします。詳細は、オブジェクト・ストレージ専用エンドポイントを参照してください。

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

ソース・ファイルがOracle Cloud Infrastructure Object Storageにあり、商用レルム(OC1)にない場合は、次の形式を使用する必要があります。

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

たとえば、商用レルム(OC1)では、Phoenixデータ・センターのbucketnameバケット内のファイルchannels.txtに対するサンプル事前認証済URIは次のとおりです:

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

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

事前認証済URLは、資格証明を作成する必要なく、Oracle Cloud Infrastructureオブジェクト・ストア内のファイルにアクセスするためのURLを取得する任意のDBMS_CLOUDプロシージャで使用できます。credential_nameパラメータにNULLを指定するか、credential_nameパラメータを指定しない必要があります。

たとえば:

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

詳細は、事前認証済リクエストの使用を参照してください。

ソース・ファイルがパブリックURLを提供するオブジェクト・ストアに存在している場合は、DBMS_CLOUDプロシージャでパブリックURLを使用できます。パブリックとは、オブジェクト・ストレージ・サービスが、オブジェクト・ストア・ファイルへの匿名の未認証アクセスをサポートすることを意味します。サポートされているオブジェクト・ストアでオブジェクトをパブリックにする方法の詳細は、対象のCloud Object Storageサービスを参照してください。

パブリックURLは、資格証明を作成することなく、オブジェクト・ストア内のファイルにアクセスするためのURLを取得するすべてのDBMS_CLOUDプロシージャで使用できます。credential_nameパラメータにNULLを指定するか、credential_nameパラメータを指定しない必要があります。

次の例では、credential_nameなしでDBMS_CLOUD.COPY_DATAを使用しています:

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

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

Oracle Cloud Infrastructureパブリック・バケットの使用方法の詳細は、パブリック・バケットを参照してください。

ソース・ファイルがOracle Cloud Infrastructure Object Storage Classicに存在する場合は、RESTページを参照して、ファイルにアクセスするためのURIフォーマットの説明を確認してください: Oracle Cloud Infrastructure Object Storage ClassicリソースのREST URLについて。

ソース・ファイルがAmazon S3にある場合、ファイルにアクセスするためのURI形式の詳細は、バケットへのアクセスを参照してください。

次の例では、us-west-2地域のadbバケットにあるファイルchannels.txtを参照します。

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

署名済URLは、資格証明を作成する必要なく、Amazon S3オブジェクト・ストア内のファイルにアクセスするためのURLを取得する任意のDBMS_CLOUDプロシージャで使用できます。DBMS_CLOUDプロシージャで署名付きURLを使用するには、credential_nameパラメータをNULLとして指定するか、credential_nameパラメータを指定しないでください。

詳細については、Share an Object with Othersを参照してください。

ソース・ファイルがAzure Blob Storageにある場合、ファイルにアクセスするためのURI形式の説明について次を参照してください: Resource URI Syntax。

次の例では、ストレージ・アカウントadb_userのadbコンテナにあるファイルchannels.txtを参照します:

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

DBMS_CLOUDは、次のサービスを含むAmazon S3互換URLをサポートするオブジェクト・ストレージ・サービス実装をサポートしています:

• Amazon S3互換URLを使用したOracle Cloud Infrastructure Object Storage
• Amazon S3互換URLを使用したGoogle Cloud Storage
• Amazon S3互換URLを使用したWasabi Hot Cloud Storage

ソース・ファイルがAmazon S3互換URIをサポートするサービスに存在する場合は、次のURI形式を使用してファイルにアクセスします:

• Oracle Cloud Infrastructure Object Storage S3互換URL

  ソース・ファイルが商用レルム(OC1)のOracle Cloud Infrastructure Object Storageに存在する場合は、商用レルム(OC1)に次に示すオブジェクトURLおよびバケットURL形式を使用することをお薦めします。詳細は、オブジェクト・ストレージ専用エンドポイントを参照してください。

  ノート
  
  OCI Object Store専用エンドポイントURLは、商用レルム(OC1)でのみサポートされています。

  オブジェクトURLフォーマット

  • 商用レルム(OC1)でのみサポートされます。

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

  • すべてのゾーンでサポートされています。

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

  バケットURLの形式:

  • 商用レルム(OC1)でのみサポートされます。

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

  • すべてのゾーンでサポートされています。

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

  詳細は、Amazon S3の互換性およびObject Storage Service APIを参照してください。

• Google Cloud Storage S3互換URL

  オブジェクトURL形式:

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

  バケットURLフォーマット:

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

  詳細については、Migrating from Amazon S3 to Cloud StorageおよびRequest Endpointsを参照してください。

• Wasabi S3互換URL

  オブジェクトURL形式:

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

  バケットURLフォーマット:

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

  詳細は、Wasabi S3 APIリファレンスおよびWasabiのストレージ・リージョンのサービスURLを参照してください。

DBMS_CLOUDは、GitHubリポジトリのデータにアクセスするためのGitHub RAW URLをサポートしています。

DBMS_CLOUD APIでGitHub RAW URLを使用して、GitHubリポジトリに存在するソース・ファイルにアクセスします。GitHub上のファイルを参照して「RAW」リンクをクリックすると、GitHub RAW URLが表示されます。raw.githubusercontent.comドメインは、GitHubリポジトリに格納されているファイルの未処理バージョンを提供します。

たとえば、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;
/

たとえば、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;

GitHubリポジトリにアクセスするためにURLを取得するDBMS_CLOUDプロシージャには、パブリック可視性GitHubリポジトリの資格証明は必要ありません。パブリック可視性URLを使用するには、credential_nameパラメータをNULLとして指定するか、credential_nameパラメータを指定しないことができます。詳細は、リポジトリの可視性の設定を参照してください。