SQL collection by Workato

SQL collection by Workato は、テーブルデータを操作するためのツールを提供する堅牢なネイティブアプリケーションです。コレクションを使用すれば、関連データを複数のシステム (データベース、Web サービス) 間で同期させることができます。

SQL collection by WorkatoSQL collection by Workato

機能の提供状況

SQL collection by Workato は、特定の料金プランに含まれています。詳細については、料金プランと契約内容をご参照ください。

コレクションを使う理由

コレクションを使用すると、複数ソースからのデータを指定して SQL 文を実行することができます。リスト入力や CSV ファイルから一時的なテーブルを作成した後、さまざまな SQL クエリーを実行して、ユースケースに必要な出力を得ることができます。

コレクションテーブル (別名、 コレクションリスト ) は、そのジョブの間だけ存在する一時的なものであり、複数のジョブにわたって保持されるものではありません。データ処理が完了したら、ターゲットシステムに直接ロードするようにしてください。

変換

コレクションは SQLite で構築されており、他のデータベースと同様に動作します。標準的な SQL 構文でリストを作成し、クエリーを実行できます。WHEREGROUP BYJOIN などの一般的な SQL キーワードを使用してテーブルのデータを操作し、目的の形式にします。

その後、コレクションの出力でデータを直接ターゲットシステムにロードするか、CSV ファイルとしてデータをエクスポートします。

コレクションによる大規模データセットの操作

コレクションは、大規模なデータセットの移動において優れた性能を発揮します。テーブルをバッチ処理し、最適な速度となるよう並列処理で実行します。1,000や10 万ものレコードを使用したレシピを、同じレベルで容易に実行します。

コレクションを使用すれば、ストレージ容量について心配する必要はありません。サードパーティ製アプリケーションを利用することなく、Workato に直接データを抽出して処理することができます。

コネクションの設定

コネクションの設定は必要ありません。 [App] > [SQL collection by Workato] を選択するだけで開始できます。

アクション

Create list in SQL collection アクションと Create list in SQL collection from CSV file アクションを使用してリスト操作を開始します。データ変換は、Query list in SQL collection アクションを使用して柔軟な SQL クエリーにより行います。

Create list in SQL collection アクション

このアクションは、リスト入力に基づき、レシピにコレクションリストを作成します。このコレクションリストには、このリストのスキーマに従った列ヘッダーが含まれます。

たとえば、 Workday のすべての Worker (従業員) のリストを取り込むことができます。

Create list in SQL collectionCreate list in SQL collection

入力項目説明
List source[datapill] リストを選択します。この項目が formula モードであることを確認します。
List nameリストの名前。
Index primaryリストのプライマリインデックスとして1つ以上の列を選択します。
Index secondaryリストのセカンダリインデックスとして1つ以上の列を選択します。

Create list in SQL collection from CSV file

このアクションは、CSV 入力に基づき、コレクションリストを作成します。コレクションリストには、この CSV 文字列のスキーマに従った列ヘッダーが含まれます。

たとえば、 オンプレミス システムからファイルを取得する場合、CSV ファイルをダウンロードして、コレクションで直接使うことができます。

Create list in SQL collection from CSV fileCreate list in SQL collection from CSV file

入力項目説明
CSV sourceソース入力として CSV 文字列を選択します。
List nameリストの名前。
File encoded typeファイルのエンコード形式を選択します。デフォルト値は UTF-8 です。
Column namesCSV ソース入力の列ヘッダー。CSV ファイルでスキーマを定義する場合は、 [use a sample CSV file] を選択します。
Ignore CSV header rowCSV ソースにヘッダー行がある場合は Yes を、そうでない場合は No を選択します。
Column delimiterCSV の各行で値を区切る文字を選択します。
Index primaryリストのプライマリインデックスとして1つ以上の列を選択します。
Index secondaryリストのセカンダリインデックスとして1つ以上の列を選択します。

コレクションリストへのクエリー

このアクションにより、リストに対して標準的な SQL クエリーを実行できます。

コレクションリストへのクエリーコレクションリストへのクエリー

入力項目説明
SQL querySQL クエリーを記述します。通常の SQL 構文が適用されます。
Output list schema出力リストの列ヘッダーに従ったスキーマを定義します。JSON でスキーマを定義する場合は、 [use sample JSON] を選択します。
Write to CSVクエリー結果を CSV 文字列に変換するには、Yes を選択します。その場合、入力項目が下に表示されます。このクエリー出力を以降の SQL クエリーで使用する場合は、No を選択します。
Add CSV headerCSV ヘッダー行として列の名前を使用する場合は Yes を、そうでない場合は No を選択します。
Column delimiterCSV の各行で値を区切る文字を選択します。

Query list アクションで使用できる、一般的な SQL キーワードを以下に示します。

SQL キーワード説明
SELECTこのリストにあるすべての列を呼び出す場合は、SQL のワイルドカード * を使用します。
WHEREリストから取得するデータの指定条件を定義します。
JOINJOINLEFT JOININNER JOIN を使用してリストを結合します。
INSERT INTOリストに新しい項目を定義します。
DELETEリストから削除する行を定義します。

エクスポートまたはターゲットシステムにロードする前に、完全なリストをクエリーすることを忘れないでください。一部の SQL キーワード (たとえば、INSERT INTODELETE) はリスト出力を返しません。そのため、これらのアクションのデータピルには、コレクションリストの行または列がすべて含まれていません。

クエリー例 : リストからの行の削除

たとえば、 Workday の Worker リストをカスタマイズして、特定のグループのメンバーを除外することができます。

コレクションリストのクエリーによる行の削除コレクションリストのクエリーによる行の削除

DELETE クエリーはリスト出力を返さないため、このステップのデータピルはリストのエクスポートに 使用しないでください。

クエリー例 : CSV としてコレクションをエクスポート

CSV として行をエクスポートCSV として行をエクスポート

SELECT クエリーを実行し、このコレクションからすべての行を取得します。

sql
SELECT * FROM workers_list

次に、アクション設定で [Write to CSV] を選択します。このアクションの出力は、CSV ファイルとして直接エクスポートできます。

Last updated: