Tablestore:DataV-Board 6.0 への接続

注意事項

• この機能は Wide Column モデルにのみ適用されます。 詳細については、「Wide Column モデル」をご参照ください。

• DataV は、データソースとして Tablestore のデータテーブルとセカンダリインデックステーブルのみをサポートします。

ステップ 1：Tablestore データソースの追加

1. DataV コンソールにログインします。

2. [データソース] タブで [データソース] を選択し、[ソースを追加] をクリックします。

3. [タイプ] リストで [TableStore] を選択します。

   [名前]、[AccessKey ID]、[AccessKey Secret]、[パブリックエンドポイント] を入力し、[OK] をクリックします。

4. Tablestore データソースのパラメーターを設定します。 詳細については、次の表をご参照ください。

   パラメーター	説明
   名前	データソースの表示名です。
   AccessKey ID	Tablestore にアクセスする権限を持つ Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID です。
   AccessKey Secret	Tablestore にアクセスする権限を持つ Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey Secret です。
   パブリックエンドポイント	アクセスする Tablestore インスタンスのエンドポイントです。 詳細については、「エンドポイント」をご参照ください。

5. [OK] をクリックします。

   DataV は、データソースをデータソースのリストに自動的に追加します。

ステップ 2：Tablestore データソースの設定

1. DataV コンソールにログインします。

2. [プロジェクト] ページで、可視化プロジェクトを作成するか、既存のプロジェクトを選択します。

   • 既存の可視化プロジェクトを使用するには、プロジェクトを見つけてそのカードの [編集] をクリックしてエディターを開きます。

   • DataV を初めて使用する場合や、既存のプロジェクトがニーズを満たさない場合は、新しいプロジェクトを作成します。

     説明

     このトピックでは、PC プロジェクトを例として使用します。

     1. [PC] をクリックします。

     2. PC テンプレートのリストでテンプレートを選択し、[プロジェクトを作成] をクリックします。

        DataV では、テンプレートまたは空白のキャンバスから可視化アプリケーションを作成できます。

     3. [プロジェクトを作成] ダイアログボックスで、可視化プロジェクトの名前を入力してグループを選択し、[作成] をクリックします。

3. Tablestore データソースを設定します。

   1. キャンバスエディターで、キャンバス上のウィジェットをクリックします。

      説明

      キャンバスにウィジェットがない場合は、まずウィジェットを追加してください。 詳細については、「アセット管理 (エンタープライズ版)」をご参照ください。

   2. 右側のウィジェット設定パネルで、 [データ] アイコンをクリックします。

   3. [データ] タブで [データソースを設定] をクリックします。

   4. [データソースを設定] セクションで、[データソースタイプ] を [TableStore] に設定します。

   5. [既存のデータソースを選択] リストから、Tablestore データソースを選択します。

   6. [アクションを選択] リストから、操作を選択します。

      次の操作がサポートされています。

      • getRow：Tablestore の GetRow API に対応します。 詳細については、「GetRow API リファレンス」をご参照ください。

      • getRange：Tablestore の GetRange API に対応します。 詳細については、「GetRange API リファレンス」をご参照ください。

      • SQL：SQL クエリ操作です。

   7. [アクションを選択] エディターで、クエリを入力します。

      getRow

      • クエリパラメーターは JSON オブジェクトである必要があります。

      • getRow 操作は、プライマリキーに基づいて 1 行のデータを読み取ります。

        次のサンプルコードは、パラメーターの形式を示しています。

        {
            "table_name": "test",
            "rows": {
                "id": "1",
                "pk": "1"
            },
            "columns": [
                "id",
                "pk",
                "test"
            ]
        }

        パラメーター	説明
        table_name	クエリ対象のテーブル名です。
        rows	行のプライマリキーです。 重要 テーブルに複数のプライマリキー列がある場合、指定する列の数とデータ型は、データテーブルの列の数とデータ型と一致する必要があります。
        columns	返す列名です。

      getRange

      • クエリパラメーターは JSON オブジェクトである必要があります。

      • getRange 操作は、指定されたプライマリキーの範囲内のデータを読み取ります。 次のサンプルコードは、パラメーターの形式を示しています。

        {
            "table_name": "test",
            "direction": "FORWARD",
            "columns": [
                "id",
                "test"
            ],
            "range": {
                "limit": 4,
                "start": {
                    "id": "InfMin"
                },
                "end": {
                    "id": "3"
                }
            }
        }

        パラメーター	説明
        table_name	クエリ対象のテーブル名です。
        direction	行を読み取る方向です。 FORWARD： 開始キーは終了キーより小さくする必要があります。 返される行は、プライマリキーの昇順でソートされます。 BACKWARD： 開始キーは終了キーより大きくする必要があります。 返される行は、プライマリキーの降順でソートされます。 たとえば、テーブルに A と B の 2 つのプライマリキー値が含まれており、A が B より小さいとします。 [A, B) から昇順で読み取る場合、A 以上 B 未満のプライマリキーを持つ行が返されます。 [B, A) から降順で読み取る場合、A より大きく B 以下のプライマリキーを持つ行が返されます。
        columns	読み取る列です。 列名は、プライマリキー列または属性列にすることができます。 列を指定しない場合、Tablestore は行全体を返します。 行のプライマリキーが読み取り範囲内にあっても、その行に指定された列が含まれていない場合、結果にはその行は含まれません。
        limit	返す最大行数です。 この値は 0 より大きい必要があります。 範囲内にさらにデータがある場合でも、Tablestore は指定された最大行数を返した後に操作を停止します。
        start	範囲読み取りの開始プライマリキーと終了プライマリキーです。 開始キーと終了キーは、有効なプライマリキー、または InfMin と InfMax で構成される仮想ポイントのいずれかである必要があります。 仮想ポイントの列数は、プライマリキー列の数と一致する必要があります。 InfMin は負の無限大を表し、他のどの値よりも小さくなります。 InfMax は正の無限大を表し、他のどの値よりも大きくなります。 重要 テーブルに複数のプライマリキー列がある場合、指定する列の数とデータ型は、データテーブルの列の数とデータ型と一致する必要があります。 start： 開始プライマリキーです。 この行が存在する場合、結果にはこの行が含まれます。 end： 終了プライマリキーです。 この行が存在するかどうかに関係なく、結果にこの行が含まれることはありません。
        end

      SQL

      カスタム SQL ステートメントを使用してデータをクエリします。

   8. [データレスポンスをプレビュー] をクリックして、返されたデータを表示します。

4. ダッシュボードをプレビューして公開します。

   1. キャンバスエディターの右上隅にある アイコンをクリックして、可視化アプリケーションをプレビューします。

   2. キャンバスエディターの右上隅にある アイコンをクリックして、ダッシュボードを公開します。

      1. [公開] ダイアログボックスで、[プロジェクトを公開] をクリックします。

      2. [公開済み] ダイアログボックスを閉じます。

         説明

         公開後、コンテンツはロックされます。 スナップショット管理を使用して、公開されたコンテンツを最新の編集内容にすばやく更新できます。 [スナップショットの管理] をクリックして、作成されたスナップショットを表示することもできます。

      3. [共有 URL] の横にある コピーアイコンをクリックします。

         このオプションは、[公開] パネルの [共有 URL] タブにあります。 リンクの形式は https://datav.aliyuncs.com/share/xxx です。

      4. ブラウザーを開き、コピーしたリンクをアドレスバーに貼り付けて、公開されたダッシュボードをオンラインで表示します。

課金

よくある質問

GetRange 操作が指定された範囲外のデータを返すのはなぜですか？

関連ドキュメント

Grafana を使用してデータを可視化することもできます。 TimeSeries モデルの時系列テーブルのデータを表示する必要がある場合は、Grafana に接続してください。 詳細については、「Grafana への接続」をご参照ください。