ストレージプロバイダーの設定

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

ストレージプロバイダーは、ストレージプロファイル設定で指定した場所にデータファイルをエクスポートできます。各プロバイダーごとに複数のプロファイルを定義できます。新しいデータエクスポートタスクを登録する際は、そのタスクに使用するプロファイルを指定します。

デフォルトで、xConnectデータエクスポートツールには以下のストレージプロバイダーが含まれます:

  • ネットワークフォルダ
  • Azure Blob Storage
  • Azure File Storage

例えば、NASやAzure以外のクラウドプロバイダーにデータファイルを保存するために、独自の カスタムプロバイダー を追加することもできます。

プロバイダーやプロファイルの変更、例えばxp1トポロジーの新しいプロファイルを定義するには、以下のすべての構成ファイルを更新する必要があります:

コンテナ/ポッド

構成ファイルパス

xdbcollection

該当しません。xdbcollectionはグローバルファイル、例えば xconnect-xp0.jsonで構成されており、これによりストレージプロバイダーの設定がxConnect Processingロールに適用されます。

皮質処理

C:\inetpub\wwwroot\App_data\config\sitecore\Processing\sc.XConnect.DataTools.Workers.xml

コルテックス処理ワーカー

C:\service\App_Data\Config\Sitecore\Processing\sc.XConnect.DataTools.Workers.xml

以下の設定が必要です:

  • Connection string (for Azure providers)
  • ストレージプロバイダーの再試行設定
  • ストレージプロファイル名、接続名、位置情報

Configure a connection string for Azure

Azure Blob StorageおよびAzure File Storage Providersでは、Azure用の接続文字列を指定する必要があります。

接続文字列を設定するには、以下を行います:

  1. 接続文字列を構築します。例えば:

  2. 以下の設定ファイルで接続文字列を追加します。

    コンテナ/ポッド

    接続文字列設定ファイル

    皮質処理

    C:\inetpub\wwwroot\app_config\ConnectionStrings.config

    コルテックス処理ワーカー

    C:\service\App_config\ConnectionStrings.config

  3. sc.XConnect.DataTools.Workers.xml設定ファイルのプロファイルノードのStorageAccountConnectionStringNameパラメータで、例えばxconnect.dataexport.storage.accountの接続文字列名を指定します。

ストレージプロバイダーの設定

各ストレージプロバイダーごとに、ネットワーク問題に対してより強靭なプロバイダーを持たせる指数関数的なリトライ設定を設定できます。

以下の再試行オプションを利用できます:

  • Max Retries – プロバイダーが諦めるまでの最大再試行回数。
  • Delay In Seconds – 再試行遅延の基準となる間隔。プロバイダーがプロセスを完了しようとするたびに、試行間隔は遅延によって増加します。例えば遅延を5秒に設定すると、プロバイダーが中断された場合は再試行前に5秒待ちます。再度中断された場合は5 + 5 = 10秒待ち、以下同様に続きます。遅延は Max Delay In Secondsの値より大きくはなりません。
  • Max Delay In Seconds – 再試行間の最大許容遅延。

例えば、xp1トポロジーについては、sc.XConnect.DataTools.Workers.xmlファイルの以下のノードでオプションを指定します。

ストレージプロバイダー

プロバイダーノード

ネットワークフォルダ

Sitecore/Processing/Services/StorageProviders.NetworkFolderProvider

Azure Blob Storage

Sitecore/Processing/Services/StorageProviders.AzureBlobStorageProvider

Azure File Storage

Sitecore/Processing/Services/StorageProviders.AzureFileStorageProvider

この例では、Azure Blob Storageのデフォルトのストレージプロバイダー構成は以下の通りです:

<StorageProviders.AzureBlobStorageProvider> Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.AzureBlobStorageProvider, Sitecore.XConnect.DataTools.CortexWorkers Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.IStorageProvider, Sitecore.XConnect.DataTools.CortexWorkers Singleton 5 <DelayInSeconds18791275782<11879127578/DelayInSeconds> 5 </StorageProviders.AzureBlobStorageProvider>

ストレージプロファイルの設定

データエクスポートツールには、各ストレージプロバイダーごとにデフォルトのプロファイルが付属しています。 sc.XConnect.DataTools.Workers.xmlファイルに追加することで、自分だけのカスタムプロファイルを定義できます。各カスタムプロファイルは1つのストレージプロバイダーに属しますが、各プロバイダーごとに何個でも設定可能です。

ストレージプロファイルの設定:

  • 以下の設定を指定します:
    • ProfileName – データエクスポートタスク登録時に使用される一意のプロファイル名。
    • StorageAccountConnectionStringName – Azureストレージプロバイダーの場合、Processing role and Processing engineで定義されたAzure Storage accountへの接続文字列の名前です。
    • Location – エクスポートされたデータファイルを保持する場所の名前。設定名は設定するストレージプロバイダーによって異なります。

sc.XConnect.DataTools.Workers.xmlファイルの以下のノードで設定を指定しています:

ストレージプロバイダー

プロファイルノード

場所の説明

ネットワークフォルダ

Sitecore/Processing/Services/StorageProviders.NetworkFolderStorageProfile.SampleProfile/Options

パラメータで、エクスポートファイルが保存されるローカルまたはネットワークフォルダを指定します。

ローカルまたはネットワークフォルダが存在しない場合、Sitecoreはエクスポートタスクを拒否します。

Azure Blob Storage

Sitecore/Processing/Services/StorageProviders.AzureBlobStorageProfile.SampleProfile/Options

パラメータでエクスポートファイルが保存されるAzureコンテナを指定します。

もしAzureストレージアカウントにコンテナが存在しなければ、Sitecoreはエクスポートタスクを拒否します。

Azure File Storage

Sitecore/Processing/Services/StorageProviders.AzureFileStorageProfile.SampleProfile/Options

およびパラメータで、エクスポートファイルが保存されるAzure共有とディレクトリを指定します。

もし共有とディレクトリがAzureストレージアカウントに存在しなければ、Sitecoreはエクスポートタスクを拒否します。

例えば、Azure Blob Storageのデフォルトプロファイル構成は以下の通りです:

<StorageProviders.AzureBlobStorageProfile.SampleProfile> Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.AzureBlobStorageProfile, Sitecore.XConnect.DataTools.CortexWorkers Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.AzureBlobStorageProfile, Sitecore.XConnect.DataTools.CortexWorkers Singleton SampleAzureBlobStorageProfile

xconnect.dataexport.storage.account

samplecontainer </StorageProviders.AzureBlobStorageProfile.SampleProfile>

この記事を改善するための提案がある場合は、 お知らせください!