機械翻訳について

「DBMS_CLOUDパッケージ・ファイル」 URI書式

DBMS_CLOUDでの操作におけるソース・ファイルURIの形式について説明します。 形式は、使用しているオブジェクト・ストレージ・サービスによって異なります。

DBMS_CLOUDにより、セキュアな通信および指定したURIが、https://をURIのプレフィクスとして使用したHTTPSを使用していることが保証されます。

Oracle Cloud Infrastructure Object StorageネイティブURIフォーマット

ソース・ファイルがOracle Cloud Infrastructure Object Storageに存在する場合、次の形式でOracle Cloud InfrastructureネイティブURIを使用できます:

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

たとえば、Phoenixデータ・センターのbucketnameバケット内のchannels.txtファイルのネイティブURIは、次のとおりです:

https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/channels.txt

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

URIは、オブジェクト・ストアの右側の省略記号メニューのOracle Cloud Infrastructure Object Storageオブジェクトの詳細から見つけることができます:

  1. Oracle Cloud Infrastructureの左側のナビゲーション・リストから、「オブジェクト・ストレージ」「オブジェクト・ストレージ」をクリックします。
  2. 「名前」列から、バケットを選択します。
  3. オブジェクト領域で、「オブジェクト詳細の表示」をクリックします。
  4. 「オブジェクトの詳細」ページの「URLパス(URI)」フィールドに、オブジェクトにアクセスするためのURIが表示されます。

注意:

ソース・ファイルはオブジェクト・ストレージ層バケットに格納する必要があります。 Autonomous Databaseでは、アーカイブ・ストレージ層のバケットはサポートされていません。 詳細については、「オブジェクト・ストレージの概要」を参照してください。

Oracle Cloud Infrastructure Object Storage Swift URI形式

ソース・ファイルがOracle Cloud Infrastructure Object Storageに存在する場合、Oracle Cloud Infrastructure Swift URIを次の形式で使用できます:

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

たとえば、Phoenixデータ・センターのbucketnameバケットに含まれるファイルchannels.txtのSwift URIは、次のとおりです:

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

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

注意:

ソース・ファイルはオブジェクト・ストレージ層バケットに格納する必要があります。 Autonomous Databaseでは、アーカイブ・ストレージ層のバケットはサポートされていません。 詳細については、「オブジェクト・ストレージの概要」を参照してください。

認証前リクエストURLを使用したOracle Cloud Infrastructure Object Storage URIフォーマット

ソース・ファイルがOracle Cloud Infrastructure Object Storageに存在する場合、Oracle Cloud Infrastructure認証前URIを使用できます。 認証前リクエストを作成すると、一意のURLが生成されます。 その後、組織、パートナまたはサードパーティのユーザーに一意のURLを指定することによって、認証前リクエストで識別されたオブジェクト・ストレージ・リソース・ターゲットにアクセスできます。

注意:

認証前アクセスに関するビジネス要件とセキュリティ上の影響を慎重に評価します。 認証前リクエストURLの作成時には、「有効期限」および「アクセス・タイプ」に注目して、使用していることを確認してください。

認証前リクエストURLは、リクエストがアクティブであるかぎり、リクエスト内で識別されたターゲットへのURLアクセス権を持つすべてのユーザーに付与します。 認証前アクセスの操作要件を考慮することに加えて、その配分を管理することも同様に重要です。

認証前リクエストのURLの形式は次のとおりです:

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

たとえば、Phoenixデータ・センターの「バケット名」バケット内のchannels.txtファイルのサンプルの認証前URIは、次のとおりです:

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

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

資格証明を作成する必要なく、Oracle Cloud Infrastructureオブジェクト・ストアのファイルにアクセスするためのURLを渡すDBMS_CLOUDプロシージャでは、認証前のURLを使用できます。 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のリストは有効です。 認証前のURLと認証が必要なURLの両方がURLリストに含まれる場合、DBMS_CLOUDは指定されたcredential_nameを使用して、認証が必要なURLおよび指定されたcredential_nameが無視される認証前のURLにアクセスします。

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

パブリックURLを使用したURI書式

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

注意:

公開Urlの使用に関するビジネス要件およびセキュリティの影響は慎重に評価してください。 ファイル・コンテンツが認証されていないため、パブリックUrlを使用する場合、これが適切であることを確認します。

パブリック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はバケット名です。 詳細については、「オブジェクト・ストレージのネームスペースについて」を参照してください。

注意:

混合URLのリストは有効です。 URLリストにパブリックURLと認証が必要なURLの両方が含まれている場合、DBMS_CLOUDは指定されたcredential_nameを使用して、認証が必要なURLおよび指定されたcredential_nameが無視されるパブリックURLにアクセスします。

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

Oracle Cloud Infrastructure Object Storage Classic URI形式

ソース・ファイルがOracle Cloud Infrastructure Object Storage Classicにある場合は、RESTページでファイルにアクセスするためのURI形式の説明を参照してください: Oracle Cloud Infrastructure Object Storage ClassicリソースのREST URLについて.

Amazon S3 URI形式

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

たとえば、以下はus-west-2リージョンのatpcバケット内のファイルchannels.txtを参照しています。

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

Azure Blob Storage URI形式

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

たとえば、以下は、ストレージ・アカウントatpc_useratpcコンテナ内のファイルchannels.txtを参照しています:
https://atpc_user.blob.core.windows.net/atpc/channels.txt