ClickHouse データベースを Quick BI に接続するために ClickHouse データソースを追加すると、Quick BI コンソールでデータを分析および表示できます。Quick BI は、インターネットまたは仮想プライベートクラウド (VPC) 経由で ClickHouse にアクセスできます。このトピックでは、グループワークスペースでユーザー作成の ClickHouse データソースを追加する方法について説明します。
前提条件
ネットワークが次の要件を満たしていること。
インターネットを使用して Quick BI を ClickHouse データベースに接続する場合は、Quick BI の IP アドレスをデータベースのホワイトリストに追加します。詳細については、「セキュリティグループルールを追加する」をご参照ください。
内部ネットワークを使用して Quick BI を ClickHouse データベースに接続する場合は、次のいずれかの方法を使用して、Quick BI とユーザー作成の ClickHouse データソース間の接続性を確保してください。
ClickHouse データベースが Elastic Compute Service (ECS) インスタンスにデプロイされている場合は、VPC を使用してデータソースにアクセスできます。
ジャンプサーバーをデプロイし、SSH トンネル経由でデータベースにアクセスできます。
ユーザー作成の ClickHouse データベースのユーザー名とパスワードを取得していること。
制限事項
データソースを追加できるのは、ワークスペース管理者と組織管理者のみです。
ClickHouse データソースは、Quick BI Pro エディションと Professional エディションでのみサポートされています。
バージョン 20.3、22.8、および 23.8 がサポートされています。
手順
Quick BI コンソール にログインします。
次の図に示す手順を実行して、ClickHouse データソースを追加します。
データソースを作成するためのエントリから、データソースの作成ページに移動します。
ユーザー作成のデータソース タブで、ClickHouse データソースを選択します。
[接続の構成] ダイアログボックスで、ビジネスシナリオに基づいて構成を完了します。
名前
説明
表示名
データソースの名前。名前はデータソースリストに表示されます。名前に特殊文字を含めたり、スペースで開始または終了したりすることはできません。
データベースアドレス
ClickHouse データベースがデプロイされているアドレス (IP アドレスまたはドメイン名を含む)。
ポート
ClickHouse データベースがデプロイされているアドレスのポート。デフォルト値: 8123。
データベース
データベースのデプロイ時にカスタマイズされる ClickHouse データベースの名前。
ユーザー名 と パスワード
ClickHouse データベースへのアクセスに使用されるユーザー名とパスワード。
タイムゾーン
ClickHouse データベースがデプロイされているタイムゾーン。
データベースバージョン
ClickHouse データベースのバージョンを選択します。
データベースバージョンが 23.8 以降の場合は、23.8 を選択します。データベースバージョンが 23.8 より前の場合は、22.8 を選択します。
SSL
宛先データソースで SSL が構成されている場合は、SSL セキュリティプロトコルを選択してデータセキュリティを保護できます。
VPC データソース
ClickHouse データベースが Alibaba Cloud ECS インスタンスにデプロイされていて、ネットワークタイプが Alibaba Cloud VPC の場合は、VPC データソース を選択し、次のパラメーターを構成します。
購入者の AccessId: インスタンスを購入したユーザーの AccessKey ID。
詳細については、「AccessKey ペアを取得する」をご参照ください。
説明AccessKey ID に宛先インスタンスに対する読み取り権限があることを確認してください。AccessKey ID に書き込み権限がある場合、システムは自動的にホワイトリストに追加します。それ以外の場合は、手動でホワイトリストに追加する必要があります。詳細については、「カスタムアクセス ポリシーを作成する」をご参照ください。
購入者の AccessKey: インスタンスを購入したユーザーの AccessKey Secret。
詳細については、「AccessKey ペアを取得する」をご参照ください。
インスタンス ID: ECS インスタンスの ID。ECS コンソールにログインし、[インスタンス] タブでインスタンス ID を取得します。
詳細については、「インスタンス情報を表示する」をご参照ください。
リージョン: ECS インスタンスが配置されているリージョン。
詳細については、「インスタンス情報を表示する」をご参照ください。
SSH
SSH を選択した場合は、次のパラメーターを構成する必要があります。
ジャンプサーバーをデプロイし、SSH トンネル経由でデータベースに接続できます。ジャンプサーバー情報を取得するには、O&M 担当者またはシステム管理者に連絡してください。
SSH ホスト: ジャンプサーバーの IP アドレスを入力します。
SSH ユーザー名: ジャンプサーバーへのログインに使用されるユーザー名。
SSH パスワード: ジャンプサーバーへのログインに使用されるユーザー名に対応するパスワード。
SSH ポート: ジャンプサーバーのポート。デフォルト値: 22。
詳細については、「パスワードを使用して Linux インスタンスに接続する」をご参照ください。
説明SSH アドレスはパブリック IP アドレスである必要があります。内部 IP アドレスはサポートされていません。
初期化 SQL
この機能を有効にすると、データソースが接続された後に実行される SQL 文を構成できます。
各データソース接続が初期化された後に実行される SQL 文。SET 文のみが許可され、文はセミコロンで区切られます。
ファイルアップロードエントリを有効にする
この機能を有効にすると、ファイルのアップロードがサポートされます。
[接続テスト] をクリックして、データソースの接続性をテストします。
テストが成功したら、[OK] をクリックしてデータソースを追加します。
次の手順
データソースを追加したら、データセットを作成してデータを分析できます。
ClickHouse データベースまたはカスタム SQL 文からデータテーブルを Quick BI に追加するには、「データセットを作成および管理する」をご参照ください。
可視化チャートを追加してデータを分析するには、「ダッシュボードを作成する」および「可視化チャートの概要」をご参照ください。
詳細な分析のためにデータをドリルダウンするには、「ドリルダウン分析を構成して表示する」をご参照ください。