1. xConnectデータ エクスポート ツール

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

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

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

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

デフォルトでは、xConnect Data Export Toolには次のストレージ プロバイダーが含まれています。

  • ネットワークフォルダ

  • Azure Blob Storage (英語)

  • Azureファイルストレージ

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

プロバイダーまたはプロファイルを変更したり、xp1トポロジなどの新しいプロファイルを定義したりするには、次のすべての構成ファイルを更新する必要があります。

コンテナ/ポッド

設定ファイルのパス

Xdbコレクション

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

Cortexプロセッシング

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

Cortexprocessingワーカー

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

次の項目を構成する必要があります。

  • 接続文字列 (Azureプロバイダー用)

  • ストレージ プロバイダーの再試行設定

  • ストレージ プロファイル名、接続名、および場所

Azureの接続文字列を構成する

Azure Blob StorageプロバイダーとAzure File Storageプロバイダーの場合は、Azureの接続文字列を指定する必要があります。

接続文字列を設定するには、次のようにします。

  1. 接続文字列を作成します。例えば：

    <add name="xconnect.dataexport.storage.account" connectionString="DefaultEndpointsProtocol=https;AccountName=teststorageaccount;AccountKey=QakK0uiWK3Tp75rOpngXwQ0pNtJTzsQGQSQVVVRloFpEiKYyPapiPGNb0yM5WgOC8+LMijRbKMzp4H+crTLcfA==;EndpointSuffix=core.windows.net" />

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

    コンテナ/ポッド

    接続文字列設定ファイル

    Cortexプロセッシング

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

    Cortexprocessingワーカー

    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ファイルストレージ

Sitecore/Processing/Services/StorageProviders.AzureFileStorageProvider

この例では、Azure Blob Storageの既定のストレージ プロバイダー構成は次のとおりです。

<StorageProviders.AzureBlobStorageProvider>
    <Type>Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.AzureBlobStorageProvider, Sitecore.XConnect.DataTools.CortexWorkers</Type>
    <As>Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.IStorageProvider, Sitecore.XConnect.DataTools.CortexWorkers</As>
    <LifeTime>Singleton</LifeTime>
    <Options>
        <ExponentialRetry>
            <MaxRetries>5</MaxRetries>
            <DelayInSeconds18791275782<11879127578/DelayInSeconds>
            <MaxDelayInSeconds>5</MaxDelayInSeconds>
        </ExponentialRetry>
    </Options>
</StorageProviders.AzureBlobStorageProvider>

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

データ エクスポート ツールには、各ストレージ プロバイダーの既定のプロファイルが付属しています。独自のカスタムプロファイルを定義するには、sc.XConnect.DataTools.Workers.xmlファイルに追加します。各カスタムプロファイルは1つのストレージプロバイダーに属しますが、プロバイダーごとに任意の数のプロファイルを持つことができます。

ストレージプロファイルを設定するには:

  • 次の設定を指定します。

    • ProfileName – データエクスポートタスクの登録中に使用される一意のプロファイル名。

    • StorageAccountConnectionStringName – Azureストレージ プロバイダーの場合、処理ロールと処理エンジンで定義されているAzure Storageアカウントへの接続文字列の名前。

    • Location – エクスポートされたデータファイルを保持する場所の名前。設定の名前は、構成するストレージプロバイダーによって異なります。

sc.XConnect.DataTools.Workers.xmlファイル内の次のノードで設定を指定します。

ストレージプロバイダー

プロファイルノード

ロケーションの説明

ネットワークフォルダ

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

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

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

Azure Blob Storage (英語)

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

<ContainerName> パラメーターで、エクスポート ファイルが格納されるAzureコンテナーを指定します。

コンテナーがAzure Storageアカウントに存在しない場合、Sitecoreはエクスポート タスクを拒否します。

Azureファイルストレージ

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

<ShareName> パラメーターと <DirectoryName> パラメーターで、エクスポート ファイルが格納されているAzure共有とディレクトリを指定します。

共有とディレクトリがAzure Storageアカウントに存在しない場合、Sitecoreはエクスポート タスクを拒否します。

たとえば、Azure Blob Storageの既定のプロファイル構成は次のとおりです。

<StorageProviders.AzureBlobStorageProfile.SampleProfile>
    <Type>Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.AzureBlobStorageProfile, Sitecore.XConnect.DataTools.CortexWorkers</Type>
    <As>Sitecore.XConnect.DataTools.CortexWorkers.DataExport.StorageProviders.AzureBlobStorageProfile, Sitecore.XConnect.DataTools.CortexWorkers</As>
    <LifeTime>Singleton</LifeTime>
    <Options>
        <ProfileName>SampleAzureBlobStorageProfile</ProfileName>
        <!--
            Defines the name of the connection string with credentials to the predefined Azure Storage Account.
        -->
        <StorageAccountConnectionStringName>xconnect.dataexport.storage.account</StorageAccountConnectionStringName>
        <!--
            Defines the name of the predefined Azure Blob Container.
        -->
        <ContainerName>samplecontainer</ContainerName>
    </Options>
</StorageProviders.AzureBlobStorageProfile.SampleProfile>
この記事を改善するための提案がある場合は、 お知らせください!