ClickHouse Cloud を接続する
ClickHouse Cloud は、高速でオープンソースのカラム型データベース管理システムで、大規模なリアルタイム分析に最適化されています。ClickHouse Cloud 連携により、使用量とコストデータを DoiT Cloud Intelligence に取り込み、Cloud Analytics(クラウド分析)で ClickHouse の支出を分析できます。
前提条件
- API キーを作成できるアクセス権を持つ ClickHouse Cloud アカウント
- Billing Profiles Admin 権限を持つ DoiT アカウント
必要な認証情報
| 項目 | 説明 | 取得場所 |
|---|---|---|
| Organization ID | ClickHouse Cloud の Organization ID(UUID 形式) | ClickHouse Cloud console → Settings → Organization |
| API Key | key_id:key_secret 形式の API キー | ClickHouse Cloud console → Settings → API Keys → Create key(Developer ロール) |
API キーを作成する
-
ClickHouse Cloud console にサインインします。
-
Settings → API Keys に移動します。
-
Create key を選択します。
-
キーに Developer ロールを割り当てます。
-
Key ID と Key Secret の両方をコピーし、
key_id:key_secretという形式で結合します。注意Key Secret は一度しか表示されません。ダイアログを閉じる前に必ずコピーしてください。
ClickHouse Cloud アカウントを接続する
-
DoiT Cloud Intelligence にサインインし、データ取り込みとインテグレーション → Assets に移動します。
-
左側のメニューから ClickHouse Cloud を選択し、Connect new account を選択します。
-
Organization ID と API Key(
key_id:key_secret形式)を入力します。 -
Test Connection を選択して、DoiT が ClickHouse データにアクセスできることを確認します。
-
テストが成功したら、保存 を選択して設定を完了してください。
テストが失敗した場合、または追加のサポートが必要な場合は、エキスパートへ問い合わせ を行ってください。
初回接続時に、DoiT は過去の使用量データを取り込みます。インポート処理には数時間かかる場合があります。データが Cloud Analytics(クラウド分析)で利用可能になると、メールでお知らせします。
データの更新頻度
DoiT は ClickHouse Cloud のデータを 6 時間 ごとに更新します。通常、使用量データは ClickHouse によって生成されてから 24〜26 時間以内に利用可能になります。
レポートのディメンション
接続が完了すると、ClickHouse Cloud のデータは次の標準 Cloud Analytics ディメンションにマッピングされます。
| Cloud Analytics ディメンション | ClickHouse の値 | 例 |
|---|---|---|
| Provider | ClickHouse Cloud | ClickHouse Cloud |
| Billing Account | Organization ID | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| Project/Account ID | Service name | my-analytics-cluster |
| Service | Entity type | service、warehouse |
| SKU | Usage type | compute、storage |
標準ディメンションに加えて、次の ClickHouse 固有ラベルも利用できます。
| ラベル | 説明 |
|---|---|
| Resource | サービスまたはエンティティ名 |
| Category | エンティティタイプ(例:service、warehouse) |
| Subcategory | Usage type(例:compute、storage) |
| Resource ID | 一意のエンティティ識別子 |
ClickHouse Cloud 接続を削除する
-
DoiT Cloud Intelligence にサインインし、データ取り込みとインテグレーション → Assets に移動します。
-
左側のメニューから ClickHouse Cloud を選択します。
-
削除したいアカウントの右端にある三点メニュー(⋮)を選択し、Delete を選択します。
-
確認のため再度 Delete を選択してください。