チェーンテンプレートWdataにデータをロードする

Load Data to Wdata テンプレートは、既存のデータセットを置き換えるか、新しいデータセットを追加することで、Wdataテーブルにデータを取り込む。このテンプレートは、既存のチェーンの一部として使用されることが最も多いが、データセットをテーブルにアップロードする必要があるワークフローに追加することもできる。

要件

ターゲットのWdataテーブルは、このチェーンを実行する前に作成されていなければならない。
このテンプレートは3つのチェーンで構成されている。各チェーンは個別に、ワークスペースに。
ファイル名には.csvまたは.tsvの拡張子を付けること。例えば"File_Name_Example.csv"。
データセットの推奨最大ファイルサイズは300MBです。推奨ファイルサイズについてはこちらをご覧ください。

テンプレートを探す

Load Data to WData テンプレートは、Templates 画面の Workiva Chains セクションにあります。

探し方はこうだ：

Chain Builderで、Templates dynamic_feedタブを開きます。
上部のメニューからWorkiva Chains を選択。
右上の「Load Data to Wdata | Primary Chain 」を検索し、テンプレートを開く。
テンプレートを見つけたら、New Chain をクリックして、ワークスペースに配置します。

注：一度設定したら、このテンプレートの各チェーンをワークスペースにパブリッシュする必要がある。

テンプレートの設定

このテンプレートは、プライマリ・チェーン、データセット置換チェーン、新規データセット追加チェーンの3つのチェーンで構成されています。プライマリ・チェーンがワークスペースに配置されると、2つの子チェーン（Add/Replace）も自動的に一緒に配置されます。

各チェーンを詳しく見てみよう：

プライマリチェーン ：このチェーンは、テーブル内にチェーンによって読み込まれるデータセットと同じ名前を持つデータセットがあるかどうかを判断します。一致するデータセットが見つかれば、チェーンは一致したデータセットの情報を取得し、親チェーンに設定した「Load Method」ランタイム入力に基づいて、そのデータを2つの子チェーンのいずれかにリダイレクトする。
Replace Dataset チェーン ：このチェーンは、マッチしたデータセットをテーブルから削除し、新しいデータセットに置き換えます。実行中にエラーが発生し、ロールバックオプションが選択された場合、チェーンは自動的に新しいデータセットを削除し、置き換えられるはずだったデータセットに戻す。
Add New Dataset チェーン ：このチェーンは新しいデータセットを作成し、テーブルにインポートします。新しいデータセットのファイル名は、テーブル内の他のデータセットで現在使われていない、一意でなければならない。

このチェーンセットを既存のチェーンに追加する場合は、プライマリー・チェーンのランタイム入力を「Run Chain」ノード内で設定する必要がある。子チェーンに変更や設定は必要ない。

設定は以下のようになるはずだ：

変数

タイプ

名称

目的

ワークスペース変数

wsv-WdataLoadWarningThreshold

この変数は、データセットのファイルサイズをソフト的に制限する働きをする。選択した閾値を超えるデータセットは警告のトリガーとなる。処理時間はファイルサイズに比例して長くなるため、より小さなデータセットでも大幅に速く処理できる。

推奨ファイルサイズは，データセットがWdata のファイルサイズ制限に近づいている可能性があることを十分に警告するものである．警告が発生したら、ファイルをリファクタリングするか、より大きなファイルを考慮した他のオプションを検討することができる。

推奨ファイルサイズ: 150MB-200MB

ダイナミック・チェーン変数

dcv-チェーン結果

様々な段階におけるチェーンの状態を把握する。これは必須であり、変更すべきではない。

ランタイム入力

ランタイム入力	目的	フィールドのタイプ	必須
テーブル ID	データセットがアップロードされるWdataテーブルIDを入力してください。このIDは、テーブル内に重複したデータセットがあるかどうかを判断するためにも使われる。ワークスペース変数を使用してテーブルIDを保存することをお勧めします。	テキスト	はい
ファイル名	Wdataテーブルにインポートされるデータセットの名前。ファイル名は、どのデータを置き換えるべきかをチェーンに伝える。ファイル名の要件は、選択したチェーンによって異なります： Add New Dataset Chain - ファイル名は、そのテーブルの他のどこにも使用してはいけません。 Replace Dataset Chain - ファイル名は置換されるデータセットと一致しなければならない。注: ファイル名には拡張子 .csv または .tsv を含める必要があります。例えば"ファイル名_例.csv"	テキスト	はい
データファイル	テーブルにインポートされるデータファイル。拡張子は.csvまたは.tsvでなければならない。注: データファイルには、サポートされているWdataテーブルの区切り文字を使用することができる。	ファイル	はい
負荷方法	既存のデータセットを置き換えるのか、新しいデータセットとして追加するのかを決定する。オプション : データセットを置換新しいデータセットを追加する	ドロップダウンメニュー	はい
ロールバック	エラーが発生した場合は、変更をすべてロールバックし、元のデータセットを再度インポートする。デフォルトではTrue に設定されている。 Replace Dataset loadメソッドにのみ適用されます。	ブール（真／偽）	いいえ

トラブルシューティング

エラーも含め、チェーンの実行履歴を見るには：

Chain BuilderのMonitor 。
クエスチョンマークにカーソルを合わせると、チェーンランのステータスが表示されます。

チェーンがエラーを引き起こしたり、正しいデータの更新に失敗した場合は、以下のチェックを行ってください：

3つのチェーンがすべてワークスペースにパブリッシュされていることを確認する。各チェーンは別々に発表されなければならない。
データセットがサポートされている区切り文字を使用し、ファイル名に.csvまたは.tsvの拡張子（"File_Name_Example.csv"）が含まれていることを確認してください。
Replace Dataset loadメソッドを使用する場合は、ファイル名がWdataテーブルの既存のファイル名と一致していることを確認してください。一致しない場合、チェーンは古いファイルを置き換えることなく、単に新しいファイルをテーブルに追加する。
逆に、Add New Dataset loadメソッドを使用する場合は、ファイル名がWdataテーブルの他の場所で使用されていないことを確認してください。重複するファイル名を使用すると、チェーンは失敗する。
Workiva 接続に関連付けられたOAuth2 グラントが適切なアクセス権を持っていることを確認してください。
テーブルIDを入力する際は、ID全体が入力され、先頭または末尾に空白がないことを確認する。
実行時のタイムスタンプ変数をチェックする。各データセットに一意なファイル名が作成されるため、これらのファイル名を使うべきではありません -- つまり、チェインがテーブル内の一致したデータセットを識別できなくなります。

カラムマッピングとその他のチェーンの修正

データをインポートする際に列ヘッダーに問題が発生した場合は、data prep 、または他のコマンドを使用することができます。

オプションインポートしたデータセットにタグを付ける

のタグ付けはデータセットのインポート時にサポートされていますが、オリジナルに変更を加える前に、テンプレートからチェーンの追加セットを配置することをお勧めします。一度変更されたチェーンは、他のテーブルのデータセットが同じタグを使用しない限り、再利用が困難になる可能性が高い。

チェーンにタグを付ける：

以下のランタイム入力を追加して、このテンプレートからデプロイされた3つのチェーンのそれぞれをする：

タグキー（テキストフィールド）

タグ値（テキストフィールド）
Primary Chain を編集して、各 "Run Chain "イベントにランタイム入力を渡す：
Replace Dataset Chain とAdd New Dataset Chain の両方で、"Import New Dataset "コマンド・ノードを編集して、タグのランタイム入力を受け付ける。