接続とクエリ

# TiDB Cloud Lake への接続とクエリ

インテグレーション > 外部データソースで TiDB Cloud Lake を追加すると、メトリクス分析、ダッシュボードなど、外部データソースをサポートするクエリエントリでこのデータソースを選択し、TiDB Cloud Lake のネイティブ読み取り専用 SQL を実行できるようになります。この接続は、Guance サーバー側が TiDB Cloud Lake Driver を介して行うため、DataFlux Func は必要ありません。

前提条件¶

• Lake DSN を取得済みであること
• Lake DSN に有効な Database と Warehouse が含まれていること
• SQL ユーザーに対象データの読み取り専用クエリ権限があること
• 現在のアカウントに外部データソースの設定権限があること

データソースの追加¶

1. インテグレーション > 外部データソースに移動します。
2. データソースを追加をクリックします。
3. 接続方法の選択で TiDB Cloud Lake ダイレクト接続を選択します。
4. データソースタイプが読み取り専用の TiDB Cloud Lake であることを確認します。
5. 接続プロパティを入力します：

TiDB Cloud Lake ダイレクト接続では、データソース ID を入力する必要はありません。DataFlux Func を介して他の外部データソースに接続する場合、既存の ID フィールドと設定要件は変更されません。

上記のフィールドを入力したら：

1. 接続テストをクリックします。システムが DSN、Warehouse、ネットワーク接続、および SQL ユーザーのクエリ権限を検証します。
2. 権限設定で、必要に応じてカスタム操作権限を有効にします：
3. 無効：”外部データソース”のデフォルト権限に従います。
4. 有効：作成者、管理者、および指定されたメンバーのみがこのデータソースを操作または使用できます。
5. データソースを保存します。

クエリでの使用¶

以下の手順は、メトリクス > メトリクス分析を例としています。ダッシュボードなど、外部データソースをサポートする他のクエリエントリでも操作は同じです。

1. メトリクス > メトリクス分析に移動します。
2. データソースクエリを追加します。
3. データソースセレクターを開き、作成したばかりの TiDB Cloud Lake データソースを選択します。
4. データソース名にカーソルを合わせると、データソースタイプ、Database、Warehouse を確認できます。
5. ネイティブの読み取り専用 SQL を入力します。
6. クエリを実行をクリックして、クエリ結果を表示します。
7. 必要に応じて、クエリ結果をダッシュボードや他のサポートされている表示シナリオに保存します。

例：

SELECT
  service,
  COUNT(*) AS log_count
FROM observability.application
WHERE event_time BETWEEN #{startTime} AND #{endTime}
GROUP BY service
ORDER BY log_count DESC
LIMIT 100;

実際のテーブル構造、フィールド名、および TiDB Cloud Lake SQL 構文に合わせて例を調整してください。

SQL の使用範囲¶

タイムアウトした場合や返却行数の制限を超えた場合は、クエリの時間範囲を狭めたり、フィルター条件を追加したり、LIMIT を使用してください。

データソースの管理¶

インテグレーション > 外部データソースページで、データソースタイプ TiDB Cloud Lake でフィルタリングするか、名前で検索できます。

• 編集：名前、説明、Lake DSN、または操作権限を変更します。
• 削除：削除すると、このデータソースを参照している既存のクエリは実行できなくなります。
• パスワード変更：TiDB Cloud Lake でパスワードを変更した後、DSN を再取得し、データソースを編集します。

結果の確認¶

設定が完了したら、次のすべての条件を満たす必要があります：

• 外部データソースが正常に保存されていること。
• 権限のあるメンバーがクエリデータソースセレクターでこのデータソースを表示できること。
• 読み取り専用 SQL を実行した後に結果が返されること。
• 権限のないメンバーはこのデータソースを選択または実行できないこと。

接続テストまたはクエリが失敗した場合は、よくある質問を参照してください。