SQLシャーディング展開ツール

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

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

SQL Sharding Deployment ToolはxDBコレクションデータベース を展開・管理する実行ファイルであり、展開するシャード数などのパラメータをより細かく制御したい場合に単体で使用できます。ツールはローカルマシンから実行しなければなりません。Azure環境からアップロード・実行することはできません。

!注Sitecoreインストールフレームワーク(SIF)とSitecore Azureツールキット(SAT)はデフォルトで2つのシャードを作成します。これは大多数のケースを処理する推奨されるシャード数です。より良いパフォーマンスのためには通常、Azureティアを増やすことを推奨しますが、シャード数を増やすのはデータベースが非常に大きい場合に限り有効です。シャード数を変更するには、xDBコレクションデータベースを再デプロイする方法があります。SIFの場合は、インストール過程で使用されるJSONファイルを変更することもできます。

このツールはxConnect Collectionサービスにバンドルされており、以下のウェブデプロイパッケージ(WDP)で利用可能です:

位相名

WDP名の例

工具の位置

XPシングル(開発者向け) - オンプレミス

Sitecore 9.X.X rev. 001250 (OnPrem)_xp0xconnect.scwdp.zip

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

XP Single(開発者向け) - クラウド

Sitecore 9.X.X rev. 001250 (Cloud)_xp0xconnect.scwdp.zip

XPスケールド - オンプレミス

Sitecore 9.X.X rev. 001564 (OnPrem)_xp1collection.scwdp.zip

XPスケールド - クラウド

Sitecore 9.X.X rev. 001564 (Cloud)_xp1collection.scwdp.zip

運用

SQLシャーディングデプロイメントツールを使って以下のようなことができます:

  • xDBコレクションのシャードクラスター(create)を作成します。例えば:

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation create /connectionstring 'user id=sa;password=12345;data source=.' /dbedition Standard /shardMapManagerDatabaseName TestDatabase /shardMapNames ContactIdShardMap,DeviceProfileIdShardMap,ContactIdentifiersIndexShardMap /shardnumber 2 /shardnameprefix Shard_ /shardnamesuffix _Sample /dacpac Sitecore.Xdb.Collection.Database.Sql.dacpac

  • xDBコレクションのハードクラスタ(drop)を外します。例えば:

    .\Sitecore.Xdb.Collection.Database.SqlShardingDeploymentTool.exe /operation drop /connectionstring "user id=sa;password=12345;data source=." /dbedition Standard /shardMapManagerDatabaseName "TestDatabase" /shardMapNames "ContactIdShardMap,DeviceProfileIdShardMap,ContactIdentifiersIndexShardMap"

パラメータ

以下の表は、SQLシャーディング展開ツールで使用されるパラメータを説明します。異なる操作は特定のパラメータセットを特定の順序で受け入れます。

パラメータ名

必須

概要

価値観/例

/operation

はい

データベースを作成するか削除するかを指定します。

  • create
  • drop

/connectionstring

はい

データベース作成に使われるSQL Serverの認証情報。

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

/dbedition

はい

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

  • ベーシック
  • 標準
  • プレミアム

/shardMapManagerDatabaseName

はい

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

例: Sample_ShardMapManagerDb

/shardMapNames

はい

シャードのメタデータとマッピングを含む、カンマ区切られたシャードマップのリスト。この値は変更しないでください。

create操作を用いた時の値

,DeviceProfileIdShardMap,ContactIdentifiersIndexShardMap。

drop操作を使用した時の値は以下の通りです

,DeviceProfileIdShardMap

/shardnumber

はい

作るシャードの数。カウントは0から始まります。

5

/shardnameprefix

はい

フォーマットは{Prefix}{Number}{Suffix}です。

例: Sample.Shard

/shardnamesuffix

はい

フォーマットは{Prefix}{Number}{Sellix}です。サフィックスは空欄のままにしても構いません。

例: _ABC

/dacpac

はい

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

  • Sitecore.Xdb.Collection.Database.Sql.dacpac (オンプレミス)
  • Sitecore.Xdb.Collection.Database.Sql.Azure.dacpac (Azure)

/log

いいえ

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

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