mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-12-15 02:41:59 +00:00

Miki Matsumoto 1e15312729 add translated Japanese docs

2024-11-18 11:58:58 +09:00

sidebar_label	sidebar_position	slug	description
クイックスタート	1	/ja/integrations/grafana	ClickHouse を Grafana で使用するための導入

import ConnectionDetails from '@site/docs/ja/_snippets/_gather_your_details_native.md';

Grafana 用 ClickHouse データソースプラグイン

Grafana を使用すると、ダッシュボードを通じてすべてのデータを探索し、共有できます。Grafana は ClickHouse に接続するためにプラグインを必要とし、これは彼らの UI から簡単にインストールできます。

1. 接続情報を集める

ClickHouse を Grafana のようなデータ可視化ツールに接続する場合、データが不適切に変更されないように読み取り専用ユーザーを作成することをお勧めします。

Grafana はクエリが安全であるかを検証しません。クエリには DELETE や INSERT を含む任意の SQL ステートメントを含めることができます。

読み取り専用ユーザーを設定するには、次の手順に従ってください：

ClickHouse でのユーザーとロールの作成ガイドに従って readonly ユーザープロファイルを作成します。
基盤となる clickhouse-go クライアントに必要な max_execution_time 設定を変更するための十分な権限が readonly ユーザーにあることを確認します。
公共の ClickHouse インスタンスを使用している場合、readonly プロファイルで readonly=2 を設定することはお勧めしません。代わりに、readonly=1 のままにし、この設定の変更を許可するために max_execution_time の制約タイプを changeable_in_readonly に設定します。

Grafana が ClickHouse へ接続できるようにする前に、適切な Grafana プラグインをインストールする必要があります。Grafana にログインしていることを前提に、次の手順に従います：

サイドバーの Connections ページから、Add new connection タブを選択します。
ClickHouse を検索し、Grafana Labs の署名されたプラグインをクリックします：

<img src={require('./images/search.png').default} class="image" alt="Connections ページで ClickHouse プラグインを選択" />
次の画面で、Install ボタンをクリックします：

<img src={require('./images/install.png').default} class="image" alt="ClickHouse プラグインをインストール" />

インストールが完了したら、Add new data source ボタンをクリックします。（Data sources タブからもデータソースを追加できます。）

<img src={require('./images/add_new_ds.png').default} class="image" alt="ClickHouse データソースを作成" />
下にスクロールして ClickHouse データソースのタイプを見つけるか、Add data source ページの検索バーで検索します。ClickHouse データソースを選択すると、以下のページが表示されます：

Server host address: ClickHouse サービスのホスト名。
Server port: ClickHouse サービスのポート。サーバー設定およびプロトコルによって異なります。
Protocol: ClickHouse サービスに接続するためのプロトコル。
Secure connection: サーバーがセキュア接続を必要とする場合に有効にします。
Username と Password: ClickHouse のユーザー資格情報を入力します。ユーザーを設定していない場合は、ユーザー名に default を試してください。読み取り専用ユーザーを設定することをお勧めします。

詳細な設定については、プラグイン設定ドキュメントを確認してください。

Save & test ボタンをクリックして、Grafana が ClickHouse サービスに接続できることを確認します。成功した場合、Data source is working メッセージが表示されます：

<img src={require('./images/valid_ds.png').default} class="image" alt="Select Save & test" />

これでデータソースの準備が整いました！query builder でクエリを構築する方法について詳しく学びましょう。

設定の詳細については、プラグイン設定ドキュメントを確認してください。

これらのドキュメントに含まれていない情報をお探しの場合は、GitHub のプラグインリポジトリを確認してください。

v4 以降では、新しいバージョンがリリースされると設定やクエリがアップグレードされます。

v3 からの設定とクエリは開いたときに v4 に移行されます。古い設定やダッシュボードは v4 でロードされますが、移行は新しいバージョンで再保存するまで保持されません。古い設定/クエリを開いた際に問題が発生した場合は、変更を破棄し、GitHub で問題を報告してください。

新しいバージョンで作成された設定/クエリを以前のバージョンにダウングレードすることはできません。