...
| Table of Contents | ||
|---|---|---|
|
概要
Yellowfinでは、SQLデータベースOutput Step（出力ステップ）を通して、変換したデータをデータベーステーブルへ保存することができます。こちらのステップの設定をするためには、対象のデータベースやテーブル、必要な更新のタイプ、マッピングするフィールドなど、関連する様々な設定を定義しなくてはいけません。こちらの項目では、それぞれの詳細について紹介します。
Yellowfinでは、SQLデータベースにアウトプットすることで、トランスフォーメーションしたデータをデータベーステーブルへ保存することができます。こちらのステップの設定をするためには、対象のデータベースやテーブル、必要な更新のタイプ、マッピングするフィールドなど、関連する様々な設定を定義しなくてはいけません。こちらの項目では、それぞれの詳細について紹介します。
| Anchor | ||||
|---|---|---|---|---|
|
...
更新のタイプから、テーブルの更新方法を選択します。すべてのオプションの詳細は、こちらを参照してください。
| Note |
|---|
「Update（更新）」、または「Update & Insert（更新と挿入）」オプションを使用する場合、さらにロウ（行）の一致が要求されます。これは、識別子に「Join（参加）」を選択するか、一致するフィールドを選択し、更新するフィールドを指定することで行われます。何も選択されていない場合は、フィールドはフローの一部としてJoin（参加）、または更新に使用されることはありません。 |
...
| Warning | ||
|---|---|---|
| ||
既存のソースデータを上書きしないために、Output Step（出力ステップ）の設定時には、細心の注意が必要です。データベースへのOutput Step（出力ステップ）には様々なオプションがあり、テーブルの削除、データの削除、新規ロウ（行）の追加、既存データの更新などを行うことができます。データ変換フローの構築には、テスト環境の使用をお勧めします。また、編集モードの場合、デフォルトでOutput Step（出力ステップ）は無効に設定されています（デザインモードオプションでの実行を参照してください） |
オプションの理解
テーブル作成オプション
| テーブル作成タイプ | 説明 |
| Use Existing（既存を使用） | 選択した既存のテーブルへデータを保存します。 |
| Create If Not Exists（既存が無い場合に作成） | 指定したテーブルが存在しない場合は、新規作成をし（または、作成された後に）、データを保存します。 |
| Drop Existing（既存を削除） | 既存のテーブルを削除し、常に新規作成をします。このオプションは、既存のデータを保持する必要が無い場合にのみ使用してください。 |
| Drop If Metadara Conflict（メタデータの競合があれば削除） | 変換フローとテーブルのデータ間のメタデータに競合がある場合（競合とは、フローファイル内のフィールド/カラム（列）数が、テーブル内と異なる場合や、データタイプが異なる場合などを指します）、テーブルを削除し、新規作成をすることでデータを保存します。競合が無い場合は、既存のテーブルを使用します。このオプションは、既存のデータを保持する必要が無い場合にのみ使用してください。 |
| Tip |
|---|
多くの場合は、「Use Existing（既存を使用）」をオプションを使用します。データベース管理者は、データ変換の対象になるテーブルを作成し、関連するセキュリティアクセスを割り当てます。 |
| Note |
|---|
稀に、対象のテーブルが存在しない場合があります。この時適切なセキュリティアクセス権が付与されていれば、Yellowfinがテーブルを作成します。Create If Not Exists（既存が無い場合に作成）オプションは、指定したテーブルが存在しない場合にテーブルを作成します。これは通常、データ変換フローを初めて実行する場合に発生し、その後は既存のテーブルが使用されることになります。Drop Existing（既存を削除）は、常にテーブルを削除し、新しく作成します。テーブルに保存されている可能性のあるデータをすべて削除するので、使用には細心の注意が必要です。Drop If Metadara Conflict（メタデータの競合があれば削除）も同様に、テーブル構造とフロー内に含まれるデータに相違がある場合は、テーブルを削除し、新しく作成します。このオプションもデータを削除するため、使用には細心の注意が必要です。 |
更新のタイプ
| 更新のタイプ | 説明 |
| Insert（挿入） | 既存のデータの最後にデータを追加をします。 |
| Truncate（置き換え） | 既存のすべてのデータを新しい値に置き換えます。これは既存のデータを削除するので、使用には細心の注意が必要です。 |
| Update（更新） | データ変換フローに存在するロウ（行）と一致するデータベース内のフィールドの値を更新します。このオプションは既存のデータを上書きするため、使用には細心の注意が必要です。 |
| Update & Insert（更新と挿入） | データ変換フローに存在するロウ（行）を一致するデータベース内のフィールドの値を更新します。このオプションは既存のデータを上書きするため、使用には細心の注意が必要です。一致するロウ（行）が存在しない場合は、新規ロウ（行）を挿入します。 |
Output Step（出力ステップ）の設定方法
...
既存のソースデータを上書きしないために、アウトプットステップの設定時には、細心の注意が必要です。データベースへのアウトプットステップには様々なオプションがあり、テーブルの削除、データの削除、新規ロウ（行）の追加、既存データの更新などを行うことができます。トランスフォーメーションフローの構築には、テスト環境の使用をお勧めします。また、編集モードの場合、デフォルトでアウトプットステップは無効に設定されています（デザインモードオプションでの実行を参照してください） |