> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Querio は、AI ネイティブの分析・ビジネスインテリジェンス向けワークスペースです。ClickHouse を Querio に接続すると、SQL、Python、AI を使ってライブデータの探索、可視化、分析を行えます。

# ClickHouse を Querio に接続する

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            コミュニティ管理
        </div>;
};

Querio は、AI を活用した分析およびビジネスインテリジェンス向けのワークスペースです。チームは SQL、Python、自然言語を使ってデータをクエリし、探索し、可視化し、インサイトを導き出せます。Querio を ClickHouse のデータベースまたは warehouse に接続すると、データを移動することなく、ClickHouse 上のデータに対して大規模なリアルタイム分析を実行し、ボード、ノートブック、AI 支援レポートを作成できます。

<div id="setup-clickhouse-for-querio">
  ## Querio 用に ClickHouse をセットアップする
</div>

<Steps>
  <Step>
    ### 専用ユーザーを作成する

    セキュリティのベストプラクティスとして、Querio 専用のユーザーアカウントを作成し、必要最小限の権限だけを付与してください。

    ```sql theme={null}
    CREATE USER querio_user IDENTIFIED BY 'STRONG_PASSWORD';
    ```

    <Tip>
      長くランダムなパスワード (16 文字以上) を使用し、できればパスワードマネージャーで生成してください。
    </Tip>
  </Step>

  <Step>
    ### 読み取り専用のデータベースアクセスを付与する

    Querio の権限は、クエリに必要なデータベースとテーブルだけに制限してください。

    ```sql theme={null}
    GRANT SELECT ON my_database.* TO querio_user;
    ```

    特定のテーブルに対しては、次を使用します。

    ```sql theme={null}
    GRANT SELECT ON database.table_name TO querio_user;
    ```

    Querio がアクセスを必要とするデータベースごとに、この手順を繰り返してください。
  </Step>

  <Step>
    ### 接続情報を確認する

    Querio を ClickHouse に接続するには、次の接続情報が必要です。

    | パラメーター     | 説明                                           |
    | ---------- | -------------------------------------------- |
    | `HOST`     | ClickHouse サーバーまたはクラスターのアドレス                 |
    | `PORT`     | ポート 9440 (セキュアなネイティブプロトコルのデフォルト) または設定済みのポート |
    | `DATABASE` | Querio でクエリする database                       |
    | `USERNAME` | `querio_user` (または選択したユーザー名)                 |
    | `PASSWORD` | user account のパスワード                          |

    <Note>
      * ClickHouse Cloud の場合、接続情報は Cloud Console で確認できます
      * セルフマネージドのインスタンスで ClickHouse が別のポートを使用している場合は、サーバー設定を確認してください
      * ポート 9440 は、セキュアなネイティブプロトコル接続のデフォルトです
    </Note>
  </Step>
</Steps>

<div id="create-account-and-connect">
  ## Querio アカウントを作成して ClickHouse に接続する
</div>

[https://app.querio.ai/](https://app.querio.ai/) にアクセスし、Querio のワークスペースにログインするか、新規作成します。

1. Querio で **Settings → Datasources** に移動し、**Add Datasource** をクリックします。

2. データベースオプションの一覧から **ClickHouse** を選択します。

3. 上記の接続情報を入力し、設定を保存します。

4. Querio が接続を検証します。検証が完了すると、ClickHouse をワークスペース全体でデータソースとして利用できるようになります。

<div id="querying-clickhouse">
  ## ClickHouse へのクエリ実行
</div>

Querio を ClickHouse に接続すると、プラットフォーム内のどこからでもデータを調査・分析できます。Querio ノートブックで SQL ブロックまたは Python セルを作成し、データソースとして ClickHouse を選択すれば、ClickHouse クラスターに対して直接クエリを実行できます。Querio の可視化機能と AI ツールを使ってインサイトを得て、ボードを作成し、結果を共有できます。

<div id="additional-resources">
  ## 参考資料
</div>

* [Querio のドキュメント](https://docs.querio.ai/integrations/clickhouse)
* [Querio のスタートガイドとチュートリアル](https://www.querio.ai)
