Azure Blob Storage ソース
Azure Blob Storageは、Microsoft Azureが提供するクラウドベースのオブジェクトストレージサービスです。 テキスト、画像、動画、バックアップ、ログなどの大量の非構造化データを保存するように設計されています。 Azure Blob Storageを使用して、文書、画像、ビデオ、音声ファイルなどの大量の非構造化データを保存および管理できます。 データのバックアップとアーカイブ、災害復旧のサポート、分析用のビッグデータワークロードの処理に最適です。
Azure Blob Storage ソースを使用してアカウントを接続し、Azure Blob StorageからAdobe Experience Platformにデータを取り込みます。
前提条件 prerequisites
Azure Blob Storage アカウントをExperience Platformに接続する前に、次の節を参照して前提条件の設定を完了してください。
IP アドレスの許可リスト
ソースをExperience Platformに接続する前に、リージョン固有のIP アドレスをードに追加する必要があります。 詳しくは、Experience PlatformへのIP アドレスの許可リストに加えるに関するガイドを参照してください。
ファイルとディレクトリの命名制約
クラウドストレージファイルまたはディレクトリに名前を付ける際に考慮する必要がある制約のリストを次に示します。
- ディレクトリ名とファイルコンポーネント名は 255 文字を超えてはなりません。
- ディレクトリ名とファイル名の末尾にスラッシュ（
/）は使用できません。 使用した場合、自動的に削除されます。 - 次の予約 URL 文字は、適切にエスケープする必要があります。
! ' ( ) ; @ & = + $ , % # [ ] - 次の文字は使用できません。
" \ / : | < > * ? - 無効な URL パス文字は使用できません。
\uE000のようなコードポイントは、NTFS ファイル名では有効ですが、有効な Unicode 文字ではありません。 また、一部の ASCII 文字や Unicode 文字、例えば制御文字（0x00 ～ 0x1F、\u0081 など）も使用できません。 HTTP/1.1 で Unicode 文字列を規定するルールについては、RFC 2616、セクション 2.2：基本ルールおよび RFC 3987 を参照してください。 - 次のファイル名は使用できません：LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、PRN、AUX、NUL、CON、CLOCK$、ドット文字（.）、2 つのドット文字（…）。
Experience PlatformにAzure Blob Storageを認証 authentication
次の認証タイプを使用して、Azure Blob Storage アカウントをExperience Platformに接続できます。
- アカウントキー認証: ストレージアカウントのアクセスキーを使用して、Azure Blob Storage アカウントを認証し、接続します。
- 共有アクセス署名（SAS）: SAS URIを使用して、Azure Blob Storage アカウント内のリソースに委任された時間制限付きアクセスを提供します。
- サービス プリンシパル ベースの認証: Azure Active Directory （AAD） サービス プリンシパル （クライアント IDとシークレット）を使用して、Azure Blob Storage アカウントに対して安全に認証します。
アカウント キー認証を使用してAzure Blob Storage アカウントをExperience Platformに接続するために、次の資格情報の値を指定します。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| 資格情報 | 説明 |
connectionString |
ストレージ アカウントのAzure Blob Storage接続文字列。 この文字列には、Azure Blob Storage インスタンスの認証と接続に必要な情報が含まれています。 形式の例：DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY};EndpointSuffix=core.windows.net |
container |
データファイルが保存されているAzure Blob Storage コンテナの名前。 コンテナは、ファイルシステム内のディレクトリと同様に、一連のBLOBを整理します。 |
folderPath |
ファイルが配置されている指定されたコンテナ内のパス。 これは、コンテナ内のオプションのサブディレクトリパス（仮想フォルダー）です。 空白のままにすると、コンテナのルートが使用されます。 |
connectionSpec.id |
接続仕様IDは、ベース接続とソース接続の作成に関連する認証仕様を含む、ソースのコネクタプロパティを返します。 Azure Blob Storageの接続仕様IDは4c10e202-c428-4796-9208-5f1f5732b1cfです。 メモ：この資格情報は、Flow Service APIを介して接続する場合にのみ必要です。 |
Azure Blob Storageでアカウント キー認証を使用する方法について詳しくは、Microsoft Azure認証ガイド を参照してください。
共有アクセス署名を使用してAzure Blob Storage アカウントをExperience Platformに接続するには、次の資格情報の値を指定します。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| 資格情報 | 説明 |
SasURI |
代替の認証タイプとしてアカウントを接続するために使用できる共有アクセス署名URI。 SAS URI パターン：https://{ACCOUNT_NAME}.blob.core.windows.net/?sv={STORAGE_VERSION}&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}。 詳しくは、共有アクセス署名URIに関するこのAzure ドキュメントを参照してください。 |
container |
データファイルが保存されているAzure Blob Storage コンテナの名前。 コンテナは、ファイルシステム内のディレクトリと同様に、一連のBLOBを整理します。 |
folderPath |
ファイルが配置されている指定されたコンテナ内のパス。 これは、コンテナ内のオプションのサブディレクトリパス（仮想フォルダー）です。 空白のままにすると、コンテナのルートが使用されます。 |
connectionSpec.id |
接続仕様IDは、ベース接続とソース接続の作成に関連する認証仕様を含む、ソースのコネクタプロパティを返します。 Azure Blob Storageの接続仕様IDは4c10e202-c428-4796-9208-5f1f5732b1cfです。 メモ：この資格情報は、Flow Service APIを介して接続する場合にのみ必要です。 |
Azure Blob Storageで共有アクセス署名を使用する方法について詳しくは、公式のMicrosoft Azure認証ガイド を参照してください。
サービスプリンシパルベースの認証を使用してAzure Blob Storage アカウントをExperience Platformに接続するために、次の資格情報の値を指定します。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| 資格情報 | 説明 |
serviceEndpoint |
Azure Blob Storage アカウントのエンドポイント URL。 通常、形式はhttps://{ACCOUNT_NAME}.blob.core.windows.netです。 |
accountKind |
Azure Blob Storage アカウントの種類。 共通の値には、Storage （汎用V1）、StorageV2 （汎用V2）、BlobStorageおよびBlockBlobStorageが含まれます。 |
servicePrincipalId |
認証に使用されるAzure Active Directory （AAD） サービス プリンシパルのクライアント/アプリケーション ID。 |
servicePrincipalKey |
Azure サービスプリンシパルに関連付けられているクライアント秘密鍵またはパスワード。 |
tenant |
サービス プリンシパルが登録されているAzure Active Directory （AAD） テナント ID。 |
container |
データファイルが保存されるAzure Blob Storage コンテナの名前。 |
folderPath |
ファイルが配置されている指定されたコンテナ内のパス。 これは、コンテナ内のオプションのサブディレクトリパス（仮想フォルダー）です。 空白のままにすると、コンテナのルートが使用されます。 |
connectionSpec.id |
接続仕様IDは、ベース接続とソース接続の作成に関連する認証仕様を含む、ソースのコネクタプロパティを返します。 Azure Blob Storageの接続仕様IDは4c10e202-c428-4796-9208-5f1f5732b1cfです。 メモ：この資格情報は、Flow Service APIを介して接続する場合にのみ必要です。 |
Azure Blob Storageでサービス プリンシパル ベースの認証を使用する方法について詳しくは、公式のMicrosoft Azure認証ガイド を参照してください。
Azure Blob StorageをExperience Platformに接続
以下のドキュメントでは、APIまたはユーザーインターフェイスを使用してAzure BlobをAdobe Experience Platformに接続する方法について説明します。