ライト テーブルの作成
シートにライト テーブルを作成して、必要に応じて軸、メジャー、編集可能な列を追加できます。アプリでライト テーブルを作成すると、そのアプリへのアクセス権とライト テーブルの権限を持つユーザーは、編集可能な列で変更を加えることができます。変更内容は外部システムにエクスポートできます。
ライト テーブルの作成
シートにはいつでもライト テーブルを追加できます。
次の手順を実行します。
-
アセット パネルで、 [チャート] を開きます。
-
[ビジュアライゼーション] で、 [ライト テーブル] をシートにドラッグします。
[軸を追加] をクリックして、軸または項目を選択します。
プロパティパネルの [データ] の
![[データ アセットの追加] メニューを開く](../../../../Resources/Images/Icons/ic_add.svg)
をクリックして、追加の軸とメジャー列を追加します。ドロップダウン メニューが開きます。次のいずれかを選択します。- 項目とマスター アイテム: すべての項目とマスター アイテムを表示する、検索可能なダイアログ ボックスを開きます。軸またはメジャーとして任意の項目を選択して追加できます。
- カスタム数式: 数式を入力できるダイアログ ボックスを開くか、数式エディター
を開きます。
プロパティパネルの [データ] の
をクリックし、 [編集可能な列] を選択して、編集可能な列を追加します。テーブルのプライマリ キーを 1 つ以上定義します。ライト テーブルの編集可能な列で、 [定義] をクリックし、プライマリ キーとして使用する軸列を 1 つ以上選択します。
プライマリ キーの詳細については、「プライマリ キー」を参照してください。
[Save] (保存)をクリックします。
ライト テーブルを作成したら、ユーザーがライト テーブルを操作して編集可能な列で変更を追加できるようにします。ライト テーブルのプロパティを構成することで、外観をカスタマイズすることもできます。「ライト テーブルのプロパティの構成」を参照してください。
変更の抽出と使用
ユーザーが編集可能な列でデータを追加しても、その変更はアプリのデータ モデルには適用されません。また、その変更は一時的なものであり、Qlik が管理する変更ストアに 90 日間保存された後、削除されます。
これらの変更は change-stores API を介して取得できます。取得した変更は、次のようなさまざまな方法で使用できます。
-
変更を QVD またはアプリにロードして、Qlik Cloud 内で永続的に保存および使用する。
-
変更を抽出して、Excel スプレッドシートや SQL データベースなどの外部システムに追加する。
-
メール送信や在庫購入など、自動化されたプロセスにデータを動的に統合する。
-
独自のアプリケーションを構築し、change-stores API への呼び出しを運用ワークフローに統合する。
前提条件
変更ストアに保存されているデータにアクセスする前に、change-stores API にアクセスできる必要があります。そのためには、次が必要です。
-
Qlik Cloud テナントの API キー。「API キーの管理」を参照してください。
-
テナント管理者が割り当てた、ライト テーブルを操作するために必要な権限。参照:
-
ライト テーブルの権限の設定 (容量ベースのサブスクリプション)
-
ライト テーブルの権限の設定 (ユーザーベースのサブスクリプション)
-
-
変更ストア ID。これは、シートにライト テーブルを作成した後に取得できます。「変更ストア」を参照してください。
変更の抽出に使用できるツール
次のツールを使用して、change-stores API から変更を抽出して使用できます。
-
Qlik Automate
-
Qlik スクリプトおよびデータの準備で使用できる REST コネクタ。
使用例やユース ケースについては、次を参照してください。
概念
このセクションでは、ライト テーブルの基本的な概念の概要を説明します。
編集可能な列
ライト テーブルでは、編集可能な列を使用することで、ユーザーは分析中にデータを即座に入力できます編集可能な列に変更を保存すると、変更内容が変更ストアに書き込まれ、アプリ開発者やインテグレーターはそこから変更内容を取得できます。
編集可能な列を作成する場所の詳細については、「ライト テーブルの作成」を参照してください。
編集可能な列を追加したら、必要に応じてさらにカスタマイズできます。
次の手順を実行します。
-
プロパティ パネルの [データ] で、編集可能な列をクリックします。
列のプロパティが開きます。
-
次のプロパティを変更できます。
-
タイトル: 既定の列タイトルを変更します。
-
コンテンツを表示: ユーザーがテーブル内のデータを編集する方法を変更します。以下から選択できます。
-
単一選択: 編集時にユーザーが各セルに対して選択できる値のセットを指定します。たとえば、注文ステータスに予定どおりと遅延の 2 つの値を追加できます。ユーザーは、データ レコードにコメントする際に、これらの値を選択できます。
-
手動ユーザー入力: ユーザーは、セルに手動でテキストを入力してデータを編集します。
-
-
列の表示: 列の表示/非表示を切り替えます。
-
列の幅: 列の幅を設定します。
-
変更ストア
変更ストアは、ライト テーブルの編集可能な列からユーザーが追加した変更を含む、Qlik が管理するストレージの場所です。変更ストアは一時的な保存場所であり、変更は最大 90 日間保存された後、削除されます。
ライト テーブルの変更ストアはテナント用に事前設定されており、change-stores API を介してアクセスできます。変更ストア ID を使用すると、ユーザーの変更をスプレッドシートやデータベースなどの永続的な場所に同期するための API リクエストや自動化を作成できます。詳細については、「変更の抽出と使用」を参照してください。
変更ストア ID は、次の 2 つの方法でコピーできます。
-
ライト テーブルを作成した後、シート編集モードの場合。プロパティパネルの [変更ストア] > [変更ストア ID] にある
をクリックします。プロパティ パネルから変更ストア ID をコピーする。
-
分析モードでライト テーブルを表示しているときの場合。右下隅にある
アイコンをクリックします。 をクリックして変更ストア ID をコピーします。ライト テーブルを表示しているときに変更ストア ID をコピーします。
プライマリ キー
ライト テーブルに編集可能な列を追加するには、少なくとも 1 つのプライマリ キーを定義する必要があります。
プライマリ キーは、編集可能な列への変更をデータ モデルからの元のデータにリンクするために使用される項目です。プライマリ キーは、データモデルのデータを表すライト テーブル内のレコードと、ユーザーが編集可能な列に加えた編集内容との間のマッピングを提供します。
プライマリ キーは、単一のフィールドにすることも、複数のフィールドにまたがる複合キーにすることもできます。
ライト テーブルでプライマリ キーを定義した後でも、いつでも変更できます。プロパティ パネルの [変更ストア] > [プライマリ キー] で、 [変更] をクリックします。
プライマリ キーは、change-stores API から変更を取得する場合にも重要です。
Qlik Cloudツールを使用してライト テーブルから変更を抽出する
Qlik Automate を使用したライト テーブルの変更の抽出
変更ストアに保存された変更は、Qlik Automate の Qlik Cloud Services コネクタにある Change Store ブロックを使用して抽出できます。このコネクタは、自動化所有者の Qlik アカウントに自動的に接続するため、認証に追加の手順は必要ありません。
Qlik Automate の詳細については、「Qlik Automate」を参照してください。
ライト テーブルの変更を抽出するために使用できる Qlik Automate ブロックへのアクセス
変更ストアから現在の変更を一覧表示する
List Current Changes From Change Store ブロックは API エンドポイント /changes/tabular-views を使用し、各セルについて最新の値のみを返します (つまり、現在の値を返します)。返されるデータは、プライマリ キーと変更された値を含むオブジェクトのリスト形式です。各レコードには、レコードが最後に更新された日時を示す updatedAt タイムスタンプ、およびこの変更を行ったユーザーの updatedBy ユーザー ID の情報が付加されます。
Qlik Automate での List Current Changes From Change Store ブロック
このブロックには、増分バリアント List Current Changes From Change Store Incrementally も存在します。このバリアントは次のように機能します。
-
最初の実行では、ブロックはすべてのレコードを取得します。
- その後の実行では、ブロックは同じレコード形式で新規および更新された値のみを取得します。
- レコード内で単一の値のみが更新された場合、このブロックはその値のみを返します (プライマリ キー、updatedAt、updatedBy パラメーターとともに）。このブロックの 2 回の実行の間に同じセルが複数回更新された場合、このブロックは最後の更新値 (「現在の」値) のみを返します。
変更ストア履歴を一覧表示する
List Change Store History ブロックは API エンドポイント /changes を使用し、各セルの完全な履歴を返します。セルが複数回更新された場合、このブロックは各更新のすべての値、userId、updatedAt タイムスタンプを返します。
Qlik Automate での List Change Store History ブロック
権限
ライト テーブルを作成し、change-stores API と連携するには、特定の権限が必要です。詳細については、「ライト テーブルの権限」を参照してください。