DBMS_CLOUD URI形式

ソース・ファイルがOracle Cloud Infrastructure Object Storageの商用レルム(OC1)に存在する場合は、オブジェクト・ストレージ専用エンドポイントを使用する次の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はバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

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

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

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

ソース・ファイルがOracle Cloud Infrastructure Object Storageの商用レルム(OC1)に存在する場合は、オブジェクト・ストレージ専用エンドポイントを使用する次の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を組織内のユーザー、パートナまたはサード・パーティに提供して、事前認証済リクエストで識別されるオブジェクト・ストレージ・リソースのターゲットにアクセスできるようにします。

ソース・ファイルがOracle Cloud Infrastructure Object Storageの商用レルム(OC1)に存在する場合は、オブジェクト・ストレージ専用エンドポイントを使用する次の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;
/

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

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

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

資格証明を作成する必要なく、オブジェクト・ストア内のファイルにアクセスするためのURLを取得する任意のDBMS_CLOUDプロシージャで、パブリックURLを使用できます。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のパブリック・バケットの使用方法の詳細は、パブリック・バケットを参照してください。

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

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

DBMS_CLOUDプロシージャおよびファンクションのobject_uriパラメータにURIを指定する場合は、Oracle Cloud Infrastructure (OCI) URLに事前定義された置換変数を指定できます。

これらの置換変数は、my$home_regionやmy$tenancyなどの事前定義されたプレースホルダであり、Autonomous Databaseのランタイム・コンテキストに基づいて、対応する実際の値で解決および置換されます。テナンシOCIDやネームスペースなどの環境固有の値はハードコードされていないため、SQLコードを動的かつ移植可能にして、複数のリージョンにデプロイできます(OCI REST APIの場合)。

OCI URLで置換変数を使用する利点は次のとおりです。

• 置換変数によってハード・コードされた値を指定する必要がなくなるため、SQLコードはエラーの発生が少なくなります。これは、長い識別子を使用するときに特に役立ちます。

• SQLコードは移植可能で、リージョンや環境に固有ではありません。現在のリージョンを識別しなくても、OCI REST APIの複数のリージョンで同じSQLコードを再利用してデプロイできます。

• OCI REST APIを使用したAutonomous Databaseのクロス・リージョン・フェイルオーバーは便利で、エラーの発生率が低くなります。

サポートされているプレースホルダのリストを次に示します。

• my$home_region: Oracle Cloud Infrastructure (OCI)テナンシのホーム・リージョンを指定します。

  my$home_region置換変数は、次の資格証明タイプでのみサポートされています。

  • OCI API署名キー

  • OCIのリソース・プリンシパル

• my$region: Autonomous DatabaseのOracle Cloud Infrastructure (OCI)リージョンを指定します。

  my$region置換変数は、次の資格証明タイプでのみサポートされています。

  • OCI API署名キー

  • OCIのリソース・プリンシパル

  • 認証トークン/Swift資格証明

• my$cloud_domain: Oracle Cloud Infrastructure (OCI)のOracle Cloud Infrastructure (OCI)ドメイン名を指定します。

  my$cloud_domain置換変数は、次の資格証明タイプでのみサポートされています。

  • OCI API署名キー

  • OCIのリソース・プリンシパル

  • 認証トークン/Swift資格証明

• my$namespace: Oracle Cloud Infrastructure (OCI)オブジェクト・ストレージ・ネームスペースを指定します。

  my$namespace置換変数は、次の資格証明タイプでのみサポートされています。

  • OCI API署名キー

  • OCIのリソース・プリンシパル

• my$compartment: コンパートメントのOCIDを指定します。

  my$compartment置換変数は、次の資格証明タイプでのみサポートされています。

  • OCI API署名キー

  • OCIのリソース・プリンシパル

  • 認証トークン/Swift資格証明

• my$tenancy: テナンシのOCIDを指定します。

  my$tenancy置換変数は、次の資格証明タイプでのみサポートされています。

  • OCI API署名キー

  • OCIのリソース・プリンシパル

  • 認証トークン/Swift資格証明

事前定義済の置換変数を使用してオブジェクト・ストレージ・ファイルにアクセスする例:

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;

事前定義済の置換変数を使用して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;

ソース・ファイルが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パラメータを指定しないようにします。

詳細は、「他のユーザーとのオブジェクトの共有」を参照してください。

ソース・ファイルがAzure Blob StorageまたはAzure Data Lake Storageにある場合、ファイルにアクセスするためのURI形式の説明は、リソースURI構文を参照してください。

たとえば、次の例で、ストレージ・アカウント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オブジェクト・ストア専用エンドポイント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互換」および「オブジェクト・ストレージ・サービスAPI」を参照してください。

• Google Cloud Storage S3互換URL

  オブジェクトURL形式:

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

  バケットURL形式:

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

  詳細は、「Amazon S3からクラウド・ストレージへの移行」および「リクエスト・エンドポイント」を参照してください。

• 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がサポートされています。

GitHub RAW URLをDBMS_CLOUD APIとともに使用して、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パラメータを指定しないようにできます。詳細は、リポジトリの可視性の設定を参照してください。