Tableau Server でのパラレル クエリの構成

tabadmin set を使用する並列クエリの制限の設定の書式は、次のとおりです。

tabadmin set native_api.connection.limit.<connection class> <n>

たとえば、グローバルな制限を設定するには、次のようにします。

tabadmin set native_api.connection.globallimit 8

または、特定のデータ ソース タイプの制限を設定するには、次のようにします。

tabadmin set native_api.connection.limit.sqlserver 5

クロスデータベースの結合に対する並列クエリを制限するには、次のようにします。

tabadmin set native_api.federated_evaluator_degree_of_parallelism 4

接続クラスの文字列のリストは、以下の「追加情報」にある「Class 文字列」を参照してください。

tsm configuration set を使用する並列クエリの制限を設定する書式は、次のとおりです。

configuration set -k native_api.connection.limit.<connection class> -v <n>

たとえば、グローバルな制限を設定するには、次のようにします。

tsm configuration set -k native_api.connection.globallimit -v 8

特定のデータ ソース タイプの制限を設定するには、次のようにします。

tsm configuration set -k native_api.connection.limit.sqlserver -v 5

クロスデータベースの結合に対する並列クエリを制限するには、次のようにします。

tsm configuration set -k native_api.federated_evaluator_degree_of_parallelism -v 4

接続クラスの文字列のリストは、以下の「追加情報」にある「Class 文字列」を参照してください。

connection-configs.xml ファイルが作成され、config ディレクトリの vizqlserver フォルダーに保存されます。config ディレクトリが正しいかどうかは、Tableau Server のバージョンとインストール済みのオペレーティング システムに依存します。

• Windows (Tableau Server 2018.1 以前) の場合:

• Windows (Tableau Server 2018.2 以降) の場合:

• Linux の場合:

この構成ファイルは、すべてのワーカー マシンのすべての vizqlserver 構成ディレクトリにコピーする必要があります。

この「Tableau Server 2018.1 以前」セクションの最後にある connection-configs.xml ファイルの例を参照してください。

データ ソース タイプ、サーバー、データベースについての情報がない <connection> タグは、他の具体的な接続の仕様によってカバーされていないすべての接続に対するクエリの最大数を定義します。例は、次のとおりです。

<connection>
<limit max='8'>
</limit>
</connection>

この値は、既定の並列クエリの制限を上書きします。vizqlserver プロセスでは、既定の制限は 16 です。データサーバー プロセスでは、既定の制限は 1,000,000 です。

注: Amazon Redshift に接続する場合、両方のプロセスで既定の制限は 8 です。

connection-configs.xml の接続設定は、異なるレベルの限定性で動作できます。接続を確立する際に、Tableau はファイルを上から下に向かって解析します。そのため、ある接続に適用されるエントリーが 1 つ以上ある場合は、ファイルの上にあるエントリーが使用されます。

このため、接続の仕様を最も限定性が強いものから弱いものの順に並べる方法も適切です。

追加の (グローバルでない) 制限は、connection-configs.xml ファイルの最上部にある <connection-list> セクションに設定します。

<connection> タグの中で使用できるパラメーターは次のとおりです。

パラメーター	文字列
class	データ ソース タイプです。すべてのデータ ソース タイプに使用できる文字列については、下の「Class 文字列」の表を参照してください。
server	サーバー コンピューターです。
dbname	データベース名です。
schema	この設定は Teradata データ ソースで使用できます。

パラメーターは任意の順番、任意の組み合わせで指定できます。たとえば、class や schema は指定せずに server と dbname を指定することが可能です。

また、Tableau Server では、VizQL Server とデータサーバーのプロセスに対して接続ごとに制限を設定し、それらのプロセスが作成できる同時接続の数を制限できます。

<limit> 要素内でプロセス属性を追加することでプロセスの制限を指定します。

プロセスのいずれかに接続制限を設定するには、次のような接続構成を作成します。

<connection class='sqlserver'>

<limit max='6' process='vizqlserver'>

</limit>

</connection>

上記の設定では、vizqlserver プロセスの同時接続数は 6 個に制限されています。データサーバー プロセスには制限が指定されていないので、接続制限はグローバル制限によって決定されます。

代わりに、次のような接続要素を作成できます。

 <connection class='sqlserver'>

<limit max='6' process='vizqlserver'>

</limit>

<limit max='12'>

</limit>

</connection>

 

前と同じように、vizqlserver プロセスの同時接続数は 6 個に制限されます。ただし、データサーバー プロセスは、グローバルな制限ではなく、この接続クラス (12) 向けの接続固有の制限を使用するようになります。<limit> 要素にプロセス属性が指定されていない場合、その制限は、接続要素内でそれより上に指定されていないすべてのサーバー プロセスに適用されます。

最後に、プロセスごとに個別の具体的な制限を設定できます。

 <connection class='sqlserver'>

<limit max='6' process='vizqlserver'>

</limit>

<limit max='12' process='dataserver'>

</limit>

</connection>

以下の例は結果的に前の例と同じ動作になりますが、今回はデータサーバーが明示的に指定されています。

接続内の両方のサーバー プロセスに制限を設定する場合、単一の <limit> 要素内に両方とも明示的に (コンマ区切りで) リストするか、プロセスを指定せずにただ <limit> 要素を使用することができます。そのため、次の 2 つの制限要素は同じです。

<limit max='10' process='dataserver, vizqlserver'>
<limit max='10'>
注: これらのプロセスの制限は、Tableau Server で並列クエリを構成する場合にのみ関係します。Tableau Desktop でプロセス制限を含む connection-configs.xml ファイルを使用する場合、プロセスの一方または両方に制限を指定する <limit> 要素はすべて無視されます。