跳到主要内容
跳到主要内容

Tableau Online

Tableau Online 可以通过官方 MySQL 数据源通过 MySQL 接口连接到 ClickHouse Cloud 或本地 ClickHouse 设置。

ClickHouse Cloud 设置


  1. ClickHouse Cloudサービスを作成した後、アプリを接続画面で、ドロップダウンからMySQLを選択します。

  1. この特定のサービスに対してMySQLインターフェースを有効にするためにスイッチを切り替えます。これによりこのサービスのポート3306が公開され、あなたのユニークなMySQLユーザー名を含むMySQL接続画面が表示されます。

既存のサービスに対してMySQLインターフェースを有効にするには、以下の手順を実行します:

  1. サービスが実行中の状態であることを確認し、MySQLインターフェースを有効にしたいサービスをクリックします。左側のメニューから「接続」を選択します:


  1. 接続先ドロップダウンからMySQLを選択します。


  1. この特定のサービスに対してMySQLインターフェースを有効にするためにスイッチを切り替えます。これによりこのサービスのポート3306が公開され、あなたのユニークなMySQLユーザー名を含むMySQL接続画面が表示されます。

ClickHouse Cloudでの複数のMySQLユーザーの作成

デフォルトでは、mysql4<subdomain>ユーザーが組み込まれており、defaultユーザーと同じパスワードを使用します。<subdomain>部分はClickHouse Cloudホスト名の最初のセグメントです。この形式は、安全な接続を実装するツールと共に動作するために必要ですが、TLSハンドシェイクでSNI情報を提供しないため、ユーザー名に追加のヒントがなければ内部ルーティングが不可能になります(MySQLコンソールクライアントがそのようなツールの一つです)。

このため、MySQLインターフェースと共に使用される新しいユーザーを作成する際には、mysql4<subdomain>_<username>形式に従うことを 強く推奨 します。ここで、<subdomain>はあなたのCloudサービスを識別するためのヒントであり、<username>はあなたの選択の任意の接尾辞です。

提示

ClickHouse Cloudのホスト名がfoobar.us-east1.aws.clickhouse.cloudの場合、<subdomain>部分はfoobarに等しく、カスタムMySQLユーザー名はmysql4foobar_team1のようになります。

MySQLインターフェースで使用するための追加ユーザーを作成することができます。たとえば、追加の設定を適用したい場合などです。

  1. オプション - カスタムユーザーに適用するための設定プロファイルを作成します。たとえば、my_custom_profileという名前の設定プロファイルを作成し、後で作成するユーザーで接続する際にデフォルトで適用される追加設定を含めます:

    prefer_column_name_to_aliasは単なる例として使用されており、他の設定を使用することができます。

  2. ユーザーの作成を以下の形式で行います:mysql4<subdomain>_<username> (上記を参照)。パスワードはダブルSHA1形式で指定する必要があります。例えば:

    または、このユーザーにカスタムプロファイルを使用したい場合:

    ここで、my_custom_profileは以前に作成したプロファイルの名前です。

  3. 権限の付与を行い、新しいユーザーに希望のテーブルまたはデータベースと対話するための必要な権限を付与します。たとえば、system.query_logへのアクセスのみを付与したい場合:

  4. 作成したユーザーを使用して、MySQLインターフェースでClickHouse Cloudサービスに接続します。

ClickHouse Cloudでの複数のMySQLユーザーに関するトラブルシューティング

新しいMySQLユーザーを作成し、MySQL CLIクライアントを通じて接続中に以下のエラーが表示された場合:

この場合、ユーザー名がmysql4<subdomain>_<username>形式に従っていることを確認してください(上記を参照)。

本地 ClickHouse 服务器设置

Please refer to the official documentation on how to set up a ClickHouse server with enabled MySQL interface.

サーバーの config.xml にエントリを追加することに加えて、次のようにすることが 必須 です。

MySQL インターフェースを使用するユーザーには、Double SHA1 パスワード暗号化 を使用する必要があります。

シェルから Double SHA1 で暗号化されたランダムなパスワードを生成するには、次のコマンドを使用します。

出力は次のようになります。

最初の行は生成されたパスワードで、2行目は ClickHouse の設定に使用できるハッシュです。

生成されたハッシュを使用する mysql_user の構成の一例は次の通りです。

/etc/clickhouse-server/users.d/mysql_user.xml

password_double_sha1_hex エントリは、生成された Double SHA1 ハッシュに置き換えてください。

さらに、use_mysql_types_in_show_columns を使用して、SHOW [FULL] COLUMNS クエリの結果で ClickHouse の型の代わりにネイティブ MySQL 型を表示することが推奨されます。これにより、BI ツールが MySQL コネクタを使用してデータベーススキーマを正しく調査できるようになります。

例えば:

/etc/clickhouse-server/users.d/mysql_user.xml

またはデフォルトのプロファイルの代わりに別のプロファイルに割り当てます。

mysql バイナリが利用可能であれば、コマンドラインから接続をテストできます。 上記のサンプルユーザー名(mysql_user)とパスワード(LZOQYnqQN4L/T6L0)を使用した場合、コマンドラインは次のようになります。

最後に、Clickhouse Server を希望の IP アドレスでリッスンするように設定します。例えば、config.xml で、すべてのアドレスでリッスンするように次の行のコメントを外します。

将 Tableau Online 连接到 ClickHouse(本地,无 SSL)

登录到您的 Tableau Cloud 站点并添加一个新的已发布数据源。


从可用连接器列表中选择“ MySQL”。


指定您在 ClickHouse 设置过程中收集的连接详细信息。


Tableau Online 将检查数据库并提供可用表的列表。将所需的表拖到右侧的画布上。此外,您可以点击“立即更新”来预览数据,并微调检查到的字段类型或名称。


之后,剩下的就是在右上角点击“发布为”,您应该能够像往常一样在 Tableau Online 中使用新创建的数据集。

注意:如果您希望将 Tableau Online 与 Tableau Desktop 结合使用并在其之间共享 ClickHouse 数据集,请确保您也使用默认 MySQL 连接器的 Tableau Desktop,按照选择 MySQL 时显示的 此处 的设置指南进行操作。如果您有 M1 Mac,请查看 此疑难解答线程 以获取驱动程序安装解决方法。

将 Tableau Online 连接到 ClickHouse(Cloud 或本地设置,带 SSL)

由于无法通过 Tableau Online MySQL 连接设置向导提供 SSL 证书, 唯一的方法是使用 Tableau Desktop 设置连接,然后将其导出到 Tableau Online。然而,这个过程相对简单。

在 Windows 或 Mac 计算机上运行 Tableau Desktop,并选择“连接” -> “到服务器” -> “ MySQL”。 可能需要首先在您的计算机上安装 MySQL 驱动程序。 您可以通过在选择数据源下拉菜单中的 MySQL 时,按照 此处 的设置指南进行操作。 如果您有 M1 Mac,请查看 此疑难解答线程 以获取驱动程序安装解决方法。


备注

在 MySQL 连接设置用户界面中,请确保启用“ SSL”选项。 ClickHouse Cloud 的 SSL 证书由 Let's Encrypt 签发。 您可以在 此处 下载此根证书。

提供您的 ClickHouse Cloud 实例 MySQL 用户凭据和下载的根证书路径。


像往常一样选择所需的表(类似于 Tableau Online), 然后选择“服务器” -> “发布数据源” -> Tableau Cloud。


重要提示:您需要在“身份验证”选项中选择“嵌入密码”。


此外,选择“更新工作簿以使用已发布的数据源”。


最后,点击“发布”,您的数据源将自动在 Tableau Online 中以嵌入凭据打开。

已知限制(ClickHouse 23.11)

ClickHouse 23.11 中修复了所有已知限制。如果您遇到其他不兼容问题,请随时 联系我们 或创建 新问题