接続のヒント
初期SQLタブ
Set Session ID チェックボックスがAdvancedタブで有効になっている場合(デフォルトで)、セッションレベルの settings を設定するために自由に使用してください。
Advancedタブ
99%のケースではAdvancedタブは必要ありませんが、残りの1%では次の設定を使用できます:
- カスタム接続パラメータ。デフォルトでは
socket_timeout
が既に指定されており、このパラメータは一部の抽出が非常に長い間更新される場合に変更する必要があるかもしれません。このパラメータの値はミリ秒単位で指定されます。その他のパラメータは こちら で確認し、カンマで区切ってこのフィールドに追加してください。 - JDBCドライバ custom_http_params。このフィールドでは、
custom_http_params
パラメータ に値を渡すことで、ClickHouse接続文字列にいくつかのパラメータを追加できます。例えば、Set Session ID チェックボックスが有効になっているときにsession_id
を指定する方法はこの通りです。 - JDBCドライバ
typeMappings
。このフィールドでは、ClickHouseデータ型をJDBCドライバで使用されるJavaデータ型にマッピングするリストを渡すことができます。このパラメータのおかげで、コネクタは大きな整数を文字列として自動的に表示しますが、 (理由は分かりません)、マッピングセットを渡すことによってこれを変更することができます。
マッピングについては、該当のセクションでさらに読むことができます。
- JDBCドライバのURLパラメータ。このフィールドでは、残りの ドライバパラメータ を渡すことができます。例えば
jdbcCompliance
などです。注意してください。パラメータの値はURLエンコード形式で渡す必要があり、このフィールドおよびAdvancedタブの前のフィールドでcustom_http_params
またはtypeMappings
を渡す場合、Advancedタブの前の2つのフィールドの値の方が優先されます。 - Set Session ID チェックボックス。これは初期SQLタブでセッションレベルの設定を設定するために必要で、タイムスタンプと擬似乱数を含む形式で
session_id
を生成します:"tableau-jdbc-connector-*{timestamp}*-*{number}*"
。
UInt64, Int128, (U)Int256データ型に対する制限付きサポート
デフォルトでは、ドライバは UInt64, Int128, (U)Int256 型のフィールドを文字列として表示しますが、表示するだけで変換はしません。これは、次の計算フィールドを書き込もうとするとエラーが発生することを意味します。
大きな整数フィールドを文字列として扱うには、そのフィールドを明示的に STR() 関数でラップする必要があります。
ただし、そのようなフィールドは、ユニークな値の数を見つけるために最もよく使用されます (Yandex.MetricaのWatch ID、Visit IDなどのID) または視覚化の詳細を指定するための Dimension として使用され、良好に機能します。
UInt64フィールドを持つテーブルのデータプレビュー(データ表示)を使用する際には、エラーは現在表示されません。