データベースから生データを抽出する公式ドキュメント
このドキュメントは、企業が利用可能な主要なデータ構造へのアクセスと説明を提供することを目的としており、適切な統合、管理、分析を容易にし、記録で見つかる可能性のある個人データの責任ある取り扱いに関する推奨事項と警告を含みます。 各テーブルの構造を説明するだけでなく、現在のプライバシーと情報セキュリティ規制の遵守の重要性を強調し、データベースの安全で適切な使用を確保するために、各フィールド定義と個人データの取り扱いに関する注意事項を慎重に確認することを推奨します。ClickHouse から HTTP と BI ツール経由でデータにアクセスする
このセクションでは、Botslovers ClickHouse データベースへの接続方法を説明します。直接 HTTP アクセス（例:curl を使用）またはグラフィカルツールとビジネスインテリジェンスツール（DBeaver、Power BI、Tableau など）経由です。
HTTP 経由でのアクセス（curl を使用した例）
ClickHouse データベースに対して直接 SQL クエリを実行してデータにアクセスできます。 基本例：messages_<company> テーブルから最初の 10 件のレコードを取得：
user と password を個人の資格情報に置き換えてください。
パラメータ
query は URL エンコードする必要があります。FORMAT を追加することで他の形式をリクエストできます：
JSON 例：
BI ツールまたはデータベースクライアントからのアクセス（DBeaver、Power BI、Tableau など）
ClickHouse は JDBC および ODBC コネクタをサポートしており、グラフィカルツールを使用してデータを探索および分析できます。DBeaver からのアクセス
- DBeaver を開き、新しい接続を作成します。
- データベースタイプとして ClickHouse を選択します。
- 接続タイプとして HTTP を選択します。
- 以下のフィールドを入力します：
- Host:
public-clickhouse.botslovers.com - ポート:
443 - ユーザー: あなたのユーザー名
- パスワード: あなたのパスワード
- SSL: 有効（ボックスがチェックされていることを確認）
- Host:
- 接続をテストして保存します。
BI ツールからのアクセス（Power BI、Tableau など）
Power BI- 公式 ClickHouse ODBC ドライバーをダウンロードしてインストールします。
- 以下のポイントを指す ODBC DSN を構成します：
- Host:
public-clickhouse.botslovers.com - ポート:
443（構成によっては8443、管理者に確認） - SSL モード: 有効
- ユーザー名/パスワード: あなたの資格情報
- Host:
- Power BI で新しい ODBC データソースを作成し、構成された DSN を選択します。
- Power BI の場合と同じように ClickHouse ODBC ドライバーを使用できます。
- または、ネイティブ ClickHouse コネクタを使用します。
セキュリティとベストプラクティス
- あなたの資格情報は個人的なもので、共有しないでください。
- 使用制限やデータ構造に関する質問がある場合は、管理者に相談してください。
- 潜在的なサービスパフォーマンス問題を防ぐために、大量のデータを抽出するクエリを避けることを推奨します。
テーブル
messages
各会話で生成された個々のメッセージが保存される中央リポジトリとして機能します。このドキュメントは、そのフィールド、目的、機密データを安全に管理するための具体的な推奨事項を詳述します。
agent_activity
参加するエージェント（人間または自動化）の関連情報を集中させるテーブル。これにより、各エージェントのイベントとメトリクスを関連付け、個々のアクティビティ分析、主要指標計算（例: 応答時間、セッションクロージャ、エージェント可用性）、転送が発生する場合でも会話全体でのアクションのトレーサビリティを容易にします。
テーブル記述
messages（テーブル: messages_<company>）
会話中に交換された各メッセージを保存します。
agent_activity（テーブル: chat_agent_log_<company>）
エージェントがチャットと対話する際に発生するイベントを記録します。
agent_status_logs（テーブル: agent_status_logs_<company>）
エージェントのステータス変更の履歴を時間の経過とともに追跡します。例えば、“online” から “break” への移行。
個人データの取り扱い
messages_ テーブル、特に text 列は、顧客のインタラクションの完全な内容を保持し、会社の提供する製品やサービスに関する名前、電子メールアドレス、ID 番号などの個人データを潜在的に含みます。
適用される規制に従ってこれらのデータを処理し、常に機密性、安全性、およびデータ主体の権利を維持することが必須です。