このトピックでは、DataVにTablestoreデータソースを追加する方法について説明します。 また、関連するパラメータについても説明します。
前提条件
追加するTablestoreデータソースが存在します。Tablestoreデータソースの追加
- にログインします。 DataVコンソール
On theマイデータタブをクリックします。データソースをクリックし、データの追加.
- [タイプ] ドロップダウンリストから [TableStore] を選択します。
- Tablestoreデータソースに関する情報を入力します。
パラメーター 説明 名前 追加するデータソースの名前。 このパラメーターをカスタム名に設定できます。 AK ID Tablestoreデータソースにアクセスする権限を持つアカウントのAccessKey ID。 AKシークレット Tablestoreデータソースにアクセスする権限を持つアカウントのAccessKeyシークレット。 インターネット 追加するTablestoreデータソースのエンドポイント。 詳細については、「エンドポイント」をご参照ください。 - Tablestoreデータソースに関する情報を入力したら、[OK] をクリックします。
追加されたデータソースがデータソースリストに表示されます。
Tablestoreデータソースの使用
- にログインします。 DataVコンソール
- [プロジェクト] タブで、編集するプロジェクトにポインターを移動し、[編集] をクリックします。 重要 [マイビジュアライゼーション] ページでビジュアライゼーションアプリケーションを作成していない場合は、「テンプレートを使用してPC側のビジュアルアプリケーションを作成する」をご参照ください。
- Canvas Editorで、キャンバス上のウィジェットをクリックします。
キャンバスにウィジェットが追加されていない場合は、最初にウィジェットを追加します。 詳細については、「ウィジェットの追加」をご参照ください。
- 右側の設定パネルで、[データ] タブをクリックし、[設定] をクリックします。
- [データソースの設定] パネルで、[データソースの種類] ドロップダウンリストから [TableStore] を選択します。
- [データソースの選択] セクションで、設定したTablestoreデータソースを選択します。
- [アクションの選択] セクションで、実行する操作を選択します。
- [アクションの選択] セクションのコードエディターで、クエリ文を入力します。
- クエリパラメーターはJSONオブジェクトである必要があります。
getRow
操作を選択すると、指定された主キーに基づいて1行のデータが読み取られます。パラメータの形式は次のとおりです。
{ "table_name": "test", "rows": { "id": "1" }, "columns": [ "id"、 "test" ] }
パート 機能 table_name クエリするTablestoreテーブルの名前。 行 行の主キー。The primary key of the row. 重要 各行に指定する主キー列の数とデータ型は、テーブルの主キー列の数とデータ型と同じである必要があります。列 返す列の名前。 getRange
操作を選択すると、指定された主キーに基づいて1行のデータが読み取られます。 パラメーターの形式は {です。 "table_name": "test", "direction": "FORWARD", "columns": [ "id"、 "test" ], "range": { "limit": 4, "start": { "id": "InfMin" }, "end": { "id": "3" } } }
パート 機能 table_name クエリするTablestoreテーブルの名前。 方向 読むための方向。 - このパラメーターをFORWARDに設定した場合、inclusive_start_primary_keyパラメーターの値はexclusive_end_primary_keyパラメーターの値より小さくなければなりません。また、応答の行は主キー値の昇順でソートされます。
- このパラメーターをBACKWARDに設定した場合、inclusive_start_primary_keyパラメーターの値はexclusive_end_primary_keyパラメーターの値よりも大きい必要があり、応答の行は主キー値の降順でソートされます。
たとえば、2つのプライマリキーaとBを含むテーブルのdirectionパラメーターをFORWARDに設定し、Aの値がBの値より小さい場合、プライマリキーの値がAの値以上でBの値より小さい行がAからBの昇順で返されます。directionパラメーターをBACKWARDに設定すると、主キーの値がBの値以下でAの値より大きい行が、BからAの降順で返されます。
列 返す列。The columns that you want to return. 主キー列または属性列の名前を指定できます。 列名を指定しない場合、行のすべてのデータが返されます。
行が主キー値に基づいて読み取る指定された範囲内にあるが、返す指定された列が含まれていない場合、応答はその行を除外します。
制限 返される行の最大数。 このパラメーターの値は0より大きくなければなりません。 指定された範囲内の一部の行が返されなくても、順方向または逆方向に返すことができる行の最大数に達すると、操作は停止します。
start 読み取る範囲の開始および終了主キー。 開始および終了プライマリキーは、InfMinおよびInfMax型のデータで構成される有効なプライマリキーまたは仮想ポイントである必要があります。 各仮想ポイントの列数は、各主キーの列数と同じである必要があります。 InfMinは無限に小さい値を示す。 他の型の値はすべてInfMinより大きくなります。 InfMaxは無限に大きな値を示す。 他の型の値はすべてInfMax未満です。
重要 各行に指定する主キー列の数とデータ型は、テーブルの主キー列の数とデータ型と同じである必要があります。- startは、開始主キーを示します。 開始主キーを含む行が存在する場合、データの行が返されます。
- endは、終了主キーを示します。 最後の主キーを含む行が存在するかどうかに関係なく、データの行は返されません。
終了
- [データ応答のプレビュー] をクリックして、返されたデータを表示します。
リクエストの例
- Tablestoreデータを準備します。
- Tablestoreコンソールにログインします。
- Tablestoreコンソールでインスタンスとテーブルを作成します。 詳細については、「インスタンスの作成」および「テーブルの作成」をご参照ください。 testインスタンスが作成されました。 このインスタンス用にテーブルが作成され、3行のデータと2列の
id (プライマリキー)
とtest
が含まれます。 id (主キー) 列はINTEGER型です。 試験カラムは、ストリング型である。 次の図は、テーブルの詳細を示しています。
- データソースを設定します。
- クエリパラメーター。The query parameter.
getRow
を使用してデータを照会します。次の結果が返されます。getRange
を使用してデータを照会します。次の結果が返されます。
説明 getRangeを使用してデータをクエリする場合、startはid: InfMin、endはid: 3です。 したがって、idが1の行とidが2の行のデータが得られる。 これは、getRangeには終了行もidが3の行も含まれていないためです。