概念: データセット スキーマの変更
スキーマは、データの組織化、構造化、および制約の方法を定義する一連のルールです。 さまざまな Workday アーティファクトおよびコンポーネントには、データセットおよびデータセット コンポーネントを含むスキーマがあります。
データセットは、どのように設定されているかによって複数のスキーマで構成されることがあります。以下の各データセット コンポーネントには、それぞれ独自のスキーマがあります。
- 基本データセットにロードする外部データを含むファイル。
- Workday データを基本データセットに取り込むために作成したカスタム レポート。
- ステージへの入力。基本データセットの最初のステージについては、このスキーマはデータセット ソースによって決定されます。
- ステージの出力。主パイプラインの最後のステージについては、このスキーマがデータセット全体の出力スキーマを決定します。
Workday を初めてご利用になる場合は、基本データセットを作成または編集する権限がありません。
スキーマの変更は、データセット内のどこでも行うことができます。以下のような場合に、新しいフィールドを追加したり、既存のフィールドを削除したりすると、スキーマが変更されます。
- Prism 計算フィールドを追加します。
- フィールドを非表示または公開
- そのステージのフィールドを追加または削除するステージを追加します。
以下の場合、基本データセットでもスキーマを変更できます。
- 外部ファイルをアップロードしてください。
- SFTP サーバーからファイルをインポートします。
- カスタム レポートからデータをインポートします。
データセットのどこで変更を加えると、他のデータセット コンポーネントに影響する可能性があります。データセット スキーマを変更すると、元のスキーマに基づいていたコンポーネントが破損する場合があります。変更がどこで行われるかは、変更の管理方法にも影響します。
スキーマを変更し、新しいソース ファイルがデータセットにインポートされたら、データセットを開いて変更を保存する必要があります。データセットを保存しない場合、引き続き古いスキーマ定義が使用されます。次回データセットをパブリッシュする際に、Prism データ ソースに一貫性のないデータが含まれる可能性があります。
SFTP サーバーまたはカスタム レポートから基本データセットのスキーマを変更するデータを SFTP サーバーまたはカスタム レポートからインポートした場合、手動で基本データセットを編集して変更を組み込む必要があります。ソース スキーマの変更によって新しいフィールドがデータセットに追加されると、それらは自動的に非表示になります。新しいフィールドを公開し、基本データセットを保存して、データセット スキーマにフィールドを含めます。
Workday では、データセットが最新であることを確認し、必要なフィールドを含めることをお勧めします。ほとんどの場合、"フィールドを管理" ステージを使用して、データセット スキーマの変更を管理します。
フィールドを管理
"フィールドを管理" ステージでは、前のステージの出力を変更をモニタリングする基準として使用します。この基準が変更されると、パイプラインの詳細パネルに警告が表示されます。基準が変更されると、"フィールドを管理" ステージで以下のように処理が行われます。
- 新規フィールドと削除されたフィールドをすべて表示します。
- データセット スキーマにすべての変更が含まれていない。
- 例: テーブルにデータは表示されません。
以下をお勧めします。
- 派生元となるテーブルまたはデータセットのスキーマを監視する場合は、派生データセットの主パイプラインの最初に "フィールドの管理" ステージを追加します。
- パブリッシュするデータセットの "主パイプライン" の最後に、"フィールドを管理" ステージを追加します。これにより、このパブリッシュ済データセットの Prism データ ソースを使用するレポートを破損する可能性のあるスキーマ変更を検出できます。
- フィールドを非表示にする必要がある場合や、新しいフィールドを表示する必要がある場合は、パイプラインの最後に "フィールドを管理" ステージを追加します。
- 基本データセットに "フィールドの管理" ステージを追加して、将来のインテグレーションが誤って既存フィールドを削除することを防ぎます。
- 1 つのパイプラインに含めるフィールドの管理ステージは 2 つまでしか含めないようにしてください。
場合によっては、"フィールドを管理" ステージを使用せずにスキーマ変更が処理されることがあります。例: ソース ファイルの新しいバージョンを基本データセットにアップロードする場合、ソース ファイルのヘッダー行に基づいてスキーマ変更が処理されます。
ソース ファイルにヘッダー行が含まれている | 結果 |
|---|---|
はい | 基本データセットのヘッダー行のフィールド名を使用して、新しいソース ファイルに含まれるフィールドを決定します。
フィールドは、ソース ファイル内の任意の場所に追加または削除できます。ソース ファイルのフィールド名が変更されない場合、新しいソース ファイルをインポートする基本データセットのスキーマが更新されます。 |
いいえ | Workday では、ソース ファイルの最後にのみ発生する変更を処理します。
新しいフィールドは、ソース ファイルの最後にのみ追加できます。置き換えた場合、新しいソース ファイルをインポートしている基本データセットのスキーマが更新されます。 |