クラウド・ストレージ・アダプタの詳細
受信アダプタと送信アダプタのどちらにも、クラウド・ストレージ・プロバイダを特定し、そのプロバイダにアクセスするために必要な認証情報を提供するプロパティが含まれています。これらのプロパティの値は、アダプタを使用するビジネス・サービスまたはビジネス・オペレーションがプロダクションに追加されると、管理ポータルで定義できます。クラウド・ストレージ・プロバイダへの接続に使用されるプロパティは次のとおりです。
設定名では AWS の用語が使用されますが、それらは、同等のプロパティに置換することによって、任意のクラウド・ストレージ・プロバイダで使用できます。例えば、Microsoft Azure を使用する場合、BucketName プロパティに “コンテナ名” を使用します。
BucketName (受信のみ) — 操作する BLOB を含むクラウド・ストレージ・バケットを指定します。送信アダプタにこの設定は含まれません。代わりに、関連するビジネス・オペレーションで BucketName プロパティを定義する必要があります。用意されているビジネス・オペレーション EnsLib.CloudStorage.BusinessOperationOpens in a new tab には、この設定が含まれています。詳細は、"ビジネス・オペレーションの作成" を参照してください。
BlobNamePrefix (受信のみ) — "BLOB の取得" を参照してください。
BlobNamePatter (受信のみ) — "BLOB の取得" を参照してください。
DeleteAfterDownload (受信のみ) — ダウンロード後に BLOB を削除する必要があることを示すには、このボックスをチェックします。
StorageProvider — クラウド・ストレージ・プロバイダを指定します。
EndPoint — PrivateLink エンドポイントを指定します。
ProviderCredentialsFile — プロバイダへのアクセスに必要な認証情報。これらは安全に格納する必要があります。認証情報ファイルのファイル・パスを指定します。
-
AWS — AWS では、これを空白のままにして、既定の認証情報プロバイダ・チェーンOpens in a new tabを使用して、S3 バケットへのアクセスに必要な認証情報を取得できます。認証情報ファイルを使用する場合は、AWS から認証情報ファイルをダウンロードしてからそのファイル・パスを指定できます。詳細は、"Sign Up for AWS and Create an IAM UserOpens in a new tab" を参照してください。
-
GCP — "サービス アカウント キーの作成と管理Opens in a new tab" に従って、アクセスの認証情報を作成します。
-
Azure — Azure は、認証情報ファイルをサポートしていません。代わりに接続文字列を使用します。詳細は、"Azure Storage の接続文字列を構成するOpens in a new tab" を参照してください。接続文字列には、セミコロンで区切られたキーと値のペアが含まれます。この文字列は編集してセミコロンを削除し、キーと値のペアのそれぞれを独自の行に配置する必要があります。
接続文字列のサンプルを以下に示します。
DefaultEndpointsProtocol=https;AccountName=sampleuser;AccountKey=5X774mvEs41WxQsOw19PB2Y;EndpointSuffix=core.windows.net
これを分解して、以下のようなファイルを作成する必要があります。
DefaultEndpointsProtocol=https AccountName=sampleuser AccountKey=5X774mvEs41WxQsOw19PB2Y EndpointSuffix=core.windows.net
StorageRegion — クラウド・ストレージのリージョンを指定します。
-
AWS — AWS リージョンのリストは、"Amazon Regions, Availability Zones, and Local ZonesOpens in a new tab" を参照してください。
-
GCP — GCP リージョンのリストは、"バケットの保存場所Opens in a new tab" を参照してください。
-
Azure — リージョンは接続文字列に暗黙的に示されます。明示的な設定は必要ありません。
クラウド・ストレージ・アダプタは、InterSystems PEX フレームワークを使用して開発されているため、このアダプタの ObjectScript ソース・コードは、他のアダプタとは異なるように見えます。例えば、送信アダプタのメソッドは、実際には Java PEX コンポーネント内に記述されたメソッドのラッパです。