# ライト テーブルからの変更の抽出

ユーザーがライト テーブル内の[編集可能な列](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/editable-column.htm)にデータを追加しても、その変更はアプリケーションのデータ モデルには適用されません。また、変更は一時的なものであり、Qlik が管理する[](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Extract/write-table-extract-data.htm#ChangeStore)[変更ストア](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/change-store.htm)に 90 日間保存された後、削除されます。

これらの変更は change-stores API を介して取得できます。取得した変更は、次のようなさまざまな方法で使用できます。

* 変更を QVD またはアプリケーションにロードして、Qlik Cloud 内で永続的に保存および使用する。

* 変更を抽出して、Excel スプレッドシートや SQL データベースなどの外部システムに追加する。

* メール送信や在庫購入など、自動化されたプロセスにデータを動的に統合する。

* 独自のアプリケーションを構築し、change-stores API への呼び出しを運用ワークフローに統合する。

## 前提条件

変更ストアに保存されているデータにアクセスする前に、change-stores API にアクセスできる必要があります。そのためには、次が必要です。

* Qlik Cloud テナントの API キー。「[API キーの管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-generate-api-keys.htm)」を参照してください。

* テナント管理者が割り当てた、ライト テーブルを操作するために必要な権限。参照:

  * [ライト テーブルの権限の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/write-table-permissions.htm) (容量ベースのサブスクリプション)

  * [ライト テーブルの権限の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/write-table-permissions-capacity.htm) (ユーザーベースのサブスクリプション)

* 変更ストア ID。これは、シートにライト テーブルを作成した後に取得できます。「[変更ストアの操作](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/change-store.htm)」を参照してください。

## 変更の抽出に使用できるツール

次のツールを使用して、change-stores API から変更を抽出して使用できます。

* Qlik Automate

* Qlik スクリプトおよびデータの準備で使用できる REST コネクタ。

使用例やユース ケースについては、次を参照してください。

* [Qlik Automate を使用したライト テーブルの変更の抽出](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Extract/write-table-extract-data.htm#ExampleAutomateMain)

* [REST コネクタを使用してライト テーブルの変更内容を抽出する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Extract/write-table-extract-data.htm#ExampleAutomate1)

* [ライト テーブルのユース ケース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Stories/stories.htm)

## Qlik Automate を使用したライト テーブルの変更の抽出

変更ストアに保存された変更は、Qlik Automate の Qlik Cloud Services コネクタにある Change Store ブロックを使用して抽出できます。このコネクタは、自動化所有者の Qlik アカウントに自動的に接続するため、認証に追加の手順は必要ありません。

Qlik Automate の詳細については、「[Qlik Automate](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_QlikAutomation/introduction/home-automation.htm)」を参照してください。

ライト テーブルの変更を抽出するために使用できる Qlik Automate ブロック

ライト テーブルの変更を抽出するために使用できる Qlik Automate ブロック

ライト テーブルの変更を抽出するために使用できる Qlik AutomateQlik Automate ブロック ![ライト テーブル変更ストアと連携するための利用可能なコネクタ ブロックによる自動化](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_write-table-automations-overview.png)

### 変更ストアから現在の変更を一覧表示する

List Current Changes From Change Store ブロックは API エンドポイント /changes/tabular-views を使用し、各セルについて最新の値のみを返します (つまり、現在の値を返します)。返されるデータは、プライマリ キーと変更された値を含むオブジェクトのリスト形式です。各レコードには、レコードが最後に更新された日時を示す updatedAt タイムスタンプ、およびこの変更を行ったユーザーの updatedBy ユーザー ID の情報が付加されます。

Qlik Automate での List Current Changes From Change Store ブロック

Qlik Automate での List Current Changes From Change Store ブロック

Qlik AutomateQlik Automate での List Current Changes From Change StoreList Current Changes From Change Store ブロック ![](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_write-table-block-change-store-list-changes.png)

### 変更ストア履歴を一覧表示する

List Change Store History ブロックは API エンドポイント /changes を使用し、各セルの完全な履歴を返します。セルが複数回更新された場合、このブロックは各更新のすべての値、userId、updatedAt タイムスタンプを返します。

Qlik Automate での List Change Store History ブロック

Qlik Automate での List Change Store History ブロック

Qlik AutomateQlik Automate での List Change Store HistoryList Change Store History ブロック![](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_write-table-block-change-history.png)

### テンプレートの操作

MySQL データベースにデータを抽出する場合、自動化テンプレートから開始することもできます。Insights to Actionで以下のテンプレートが利用可能です:

* Extract Change Store Data to a MySQL Database

* Extract Change Store Data to a MySQL Database in Bulk

これらのテンプレートは、Change Storeブロック (上記で説明) を他のブロックと配置して、データの抽出を高速化するのに役立ちます。ブロック パラメータを調整するだけで、リソースに接続できます。詳細な手順については、[こちらのコミュニティ記事](https://community.qlik.com/t5/Official-Support-Articles/How-to-extract-changes-from-the-Change-Store-Write-Table-and/ta-p/2537848)を参照してください。

## REST コネクタを使用してライト テーブルの変更内容を抽出する

この例では、change-stores API への REST 接続を構成する方法を示します。 この接続を使用して、API から変更内容を取得し、アプリケーションにロードしたり、Qlik Cloud 内の QVD に保存したりできます。

次の手順を実行します。

1. Qlik Cloud Analytics で、REST コネクタへの新しい接続を作成します。「[データ接続の追加](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataSource/add-data-connections.htm)」を参照してください。

2. 接続に次のパラメーターを設定します。

   * URL: &lt;your\_tenant\_base\_URL&gt;/api/analytics/change-stores/&lt;your change store id&gt;/changes/tabular-views

   * Additional request parameters

     * Query parameters

       * Limit (Key): 100 (Value)

     * Query headers

       * Authorization (Key): Bearer &lt;your\_API\_token&gt; (Value)

   * Pagination type: Next URL

     * 'Next url' path: links/next/href

## 詳細を見る

* [Qlik Automate を使用して、\[変更ストア\] (書き込みテーブル) から変更点を抽出し、データベースに保存する方法](https://community.qlik.com/t5/Official-Support-Articles/How-to-extract-changes-from-the-Change-Store-Write-Table-and/ta-p/2537848)

* [変更ストアの操作](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/change-store.htm)

* [ライト テーブルの作成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/create.htm)

* [ライト テーブル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Analyze/write-table.htm)

* [編集可能な列の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/editable-column.htm)

* [ライト テーブルのプライマリ キー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/WriteTable/Create/primary-key.htm)