1. xDB Collectionデータベースのスケーリングと構成

SQLシャーディング デプロイ ツール

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

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

SQL Sharding Deployment Toolは、xDB Collectionデータベース をデプロイおよび管理する実行可能ファイルであり、デプロイするシャードの数などのパラメーターをより詳細に制御する場合は、単独で使用できます。このツールは、ローカル コンピューターから実行する必要があります。Azure環境からアップロードして実行することはできません。

メモ

Sitecore Installation Framework (SIF) とSitecore Azure Toolkit (SAT) は、デフォルトで2つのシャードを作成します。シャードの数を変更するには、xDB Collectionデータベースを再デプロイします。SIFの場合、インストール プロセス中に使用されるJSONファイルを変更することもできます。

場所

このツールはxConnect Collection serviceにバンドルされており、次のWebデプロイ パッケージ (WDP) で利用できます。

トポロジ名

WDP名の例

ツールの場所

XP Single (Developer) - オンプレミス

Sitecore 10.0.0 rev. 001250 (OnPrem)_xp0xconnect.scwdp.zip

\Content\Website\App_Data\collectiondeployment\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe

XP Single (Developer) -雲

Sitecore 10.0.0 rev. 001250 (Cloud)_xp0xconnect.scwdp.zip

XP Scaled - オンプレミス

Sitecore 10.0.0 rev. 001564 (OnPrem)_xp1collection.scwdp.zip

XP Scaled -雲

Sitecore 10.0.0 rev. 001564 (Cloud)_xp1collection.scwdp.zip

オペレーションズ

SQLシャーディング デプロイメント ツールを使用すると、次のことができます。

  • xDB Collectionシャード クラスター (create) を作成します。例えば：

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation create /connectionstring "user id=sa;password=12345;data source=./SQL2017;" /shardMapManagerDatabaseName "Sitecore.Xdb.Collection.Database.Sql.ShardMapManagerDb" /shardnumber 2 /shardnameprefix "Sitecore.Xdb.Collection.Database.Sql" /shardnamesuffix "_" /dacpac ".\Sitecore.Xdb.Collection.Database.Sql.dacpac"

  • xDB Collectionシャードクラスター (drop) をドロップします。例えば：

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation drop /connectionstring "user id=sa;password=12345;data source=.\SQL2017;" /shardMapManagerDatabaseName "Sitecore.Xdb.Collection.Database.Sql.ShardMapManagerDb"

  • シャードクラスターにシャードを追加します (addShard)。例えば：

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation addShard /connectionstring "user id=sa;password=12345;data source=./SQL2017;" /shardMapManagerDatabaseName "Sitecore.Xdb.Collection.Database.Sql.ShardMapManagerDb" /shardConnectionString "user id=sa;password=12345;data source=./SQL2017;" /shardnameprefix "Sitecore.Xdb.Collection.Database.Sql" /shardnamesuffix "_" /dacpac ".\Sitecore.Xdb.Collection.Database.Sql.dacpac"
    手記

    このコマンドはクラウド環境でのみ使用でき、オンプレミスでは使用できません。

  • シャードクラスター (deleteShard) からシャードを削除します。例えば：

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation deleteShard /connectionstring "user id=sa;password=12345;data source=.\SQL2017;" /shardMapManagerDatabaseName "Sitecore.Xdb.Collection.Database.Sql.ShardMapManagerDb" /shardConnectionString "user id=sa;password=12345;data source=.\SQL2017;" /shardDatabaseName "Sitecore.Xdb.Collection.Database.Sql2_"

  • シャード マップのキー範囲 (printMapping) を印刷します。例えば：

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation printMapping /connectionstring "user id=sa;password=12345;data source=.\SQL2017;" /shardMapManagerDatabaseName "Sitecore.Xdb.Collection.Database.Sql.ShardMapManagerDb"

  • ShardMapManagerのスキーマを登録します (registerSchema。例えば：

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation registerSchema /connectionstring "user
id=sa;password=12345;data source=.\SQL2017;" /shardMapManagerDatabaseName "Sitecore.Xdb.Collection.Database.Sql.ShardMapManagerDb"
大事な

SQLシャーディング配置ツールを使用してシャードを追加または削除しても、既存のデータは自動的に分割およびマージされません。SQLシャーディング デプロイメント ツールは、分割およびマージ操作の実行の一部として使用します。

スキーマの登録は、分割およびマージ操作の前提条件の1つです。スキーマが登録されていない場合、分割およびマージ操作ではデータを移行できません。

パラメーター

次の表では、SQLシャーディング デプロイメント ツールで使用されるパラメーターについて説明します。さまざまな操作で特定のパラメーター セットが受け入れられます。

パラメータ名

必須

形容

値/例

/operation

はい

実行する操作を指定します。

  • create

  • drop

  • addShard

  • deleteShard

  • printMapping

  • registerSchema

/connectionstring

はい

データベースの作成に使用されるSQL Server接続文字列。

"user id=sa;password=SamplePassword;data source=.\SQL2016"

/dbedition

いいえ

Azure SQL DTUベースのサービス階層。 この値は、Azure SQLにデプロイする場合にのみ使用されます。

  • 基本的な

  • 標準

  • プレミアム

  • 汎用

  • ビジネスクリティカル

/shardMapManagerDatabaseName

はい

シャード マップ マネージャー データベースの名前。

例： Sample_ShardMapManagerDb

/shardnumber

はい

作成するシャードの数。

5

/shardnameprefix

いいえ

形式は {プレフィックス}{番号}{サフィックス} です。

例： Sample.Shard

/shardnamesuffix

いいえ

形式は {プレフィックス}{番号}{サフィックス} です。サフィックスは空白のままにすることができます。

例： _ABC

/dacpac

はい

DACPACファイルへのパス。デフォルトでは、DACPACファイルはツールと同じフォルダーにあります。

  • Sitecore.Xdb.Collection.Database.Sql.dacpac

/log

いいえ

ログファイルへのパス。ログファイルが指定されていない場合、出力はコンソールに書き込まれます。

/shardConnectionString

はい

addShardおよび/deleteShard操作で使用されます。

/shardDatabaseName

はい

/deleteShard操作で使用されます。

/force

いいえ

/addShard操作で使用される省略可能なパラメーター。スキーマ比較なしでシャードを強制的に追加します。

- true

- false

/elasticpool

いいえ

クラスター データベースをデプロイする登録済みのエラスティック プールの名前。引数はSQL Azure固有です。

createおよびaddShardと一緒に使用してください。

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