接続のヒント

初期 SQL タブ

Set Session ID チェックボックスが詳細タブで有効になっている場合（デフォルト）、セッションレベルの 設定 を以下のように設定できます。

詳細タブ

99% のケースでは詳細タブを使用する必要はありませんが、残りの 1% のために以下の設定を使用できます：

• カスタム接続パラメータ。デフォルトでは socket_timeout が既に指定されています。このパラメータは、一部の抽出が非常に長い時間更新される場合に変更する必要があるかもしれません。このパラメータの値はミリ秒単位で指定されます。他のパラメータについては こちら で確認し、カンマで区切ってこのフィールドに追加してください。

• JDBC ドライバ custom_http_params。このフィールドでは、ClickHouse 接続文字列にいくつかのパラメータを追加することができます。custom_http_params パラメータに値を渡すことで実現します。例えば、Set Session ID チェックボックスが有効になっている場合、session_id はこのように指定されます。

• JDBC ドライバ typeMappings。このフィールドでは、ClickHouse のデータ型マッピングを JDBC ドライバで使用する Java データ型のリストとして渡すことができます。このパラメータのおかげで、コネクタは大きな整数を文字列として自動的に表示しますが、このマッピングセットを渡すことで変更できます (理由はわかりません)。

  マッピングの詳細については、該当するセクションを参照してください。

• JDBC ドライバ URL パラメータ。残りの ドライバパラメータ、例えば jdbcCompliance をこのフィールドに渡すことができます。注意してください。パラメータの値は URL エンコード形式で渡す必要があり、custom_http_params または typeMappings をこのフィールドと詳細タブの前のフィールドに渡す場合、詳細タブの両方の先行フィールドの値が優先されます。

• Set Session ID チェックボックス。これは初期 SQL タブでセッションレベルの設定を行うために必要で、タイムスタンプと擬似乱数を持つ session_id を "tableau-jdbc-connector-*{timestamp}*-*{number}*" という形式で生成します。

UInt64、Int128、(U)Int256 データ型のサポートを制限

デフォルトでは、ドライバは UInt64、Int128、(U)Int256 型のフィールドを文字列として表示しますが、表示するだけで変換はしません。これは、次の計算フィールドを記述しようとするとエラーが発生することを意味します。

大きな整数フィールドを文字列として扱うには、フィールドを STR() 関数で明示的にラップする必要があります。

しかし、そのようなフィールドは大抵、ユニークな値の数を見つけるために使用されます (Watch ID や Visit ID などの ID、Yandex.Metrica における) または視覚化の詳細を指定する Dimension として使用され、正常に機能します。

UInt64 フィールドを持つテーブルのデータプレビュー（データの表示）を使用する際、エラーは今は表示されません。