コンテンツにスキップ

複数テーブル結合ステップは、ビジュアルな結合グラフデザイナーを使用して、1回の操作で多数のテーブル(最大32個)を結合します。2テーブルの結合ステップを連鎖させるパターンに代わるものです。テーブルを追加し、列間の結合を描画し、結合ごとに結合タイプと条件を選択して、出力列をマッピングします。エディターには3つのタブがあります: Tables & Joins、出力列、Post-Join Filter。

詳しい手順については、複数テーブル結合ステップガイドを参照してください。

orderscustomersitemsregions1ステップ結合結果最大32テーブル
ソーステーブル間の結合をグラフとして描画します(最大32テーブル)。多数の2テーブル結合を連鎖させる代わりに、グラフ全体が1つのステップで1つの結果テーブルになります。
  • テーブルを追加 — ソーステーブルを、列のカードとしてキャンバスに配置します。各テーブルにはエイリアス(alias.columnとして使用)があり、英字またはアンダースコアで始まる必要があり、SQLキーワードにはできません。
  • ターゲットテーブル — 結合結果の書き込み先となるテーブルです。存在しない場合は作成されます。
  • 動的 — ソースまたはターゲットを、選択する代わりに参照として指定します。テーブル名、プロジェクトパス(/03 Results/FACT_GL)、またはどちらかに実行時に解決される{variable}トークンを含めたものです。動的なソースの列は設計時に読み取れないため、サイドパネルで手動で入力します。
  • 結合を描画 — あるテーブルの列のドットから別のテーブルの列へドラッグして、結合を作成します。任意のラベルでエッジに名前を付けられます。
  • 結合前フィルター — 結合の前に適用される、テーブルごとのフィルターです。
  • サーバーから再取得 — テーブルカードの列を最新のカタログから更新します。
  • レイアウトを整理 / 全体表示 / 1:1 — グラフを自動配置する、全体が収まるようにズームする、または100%に戻します。ズームボタン、マウスホイール、パンも利用でき、ミニマップにはグラフ全体が表示されます。
  • 元に戻す / やり直し / 履歴 — 編集を前後に移動し、確認し、復元します。
  • 列をフィルター… — テーブルカードに表示する列を絞り込みます。
  • PDFとしてエクスポート / PNGとしてエクスポート — エクスポートボタンとそのメニューから、結合の図をダウンロードします。
タイプ 保持する行
INNER 結合したテーブル間で一致する行。
LEFT 左テーブルのすべての行と、右テーブルの一致した行。
FULL 両方のテーブルのすべての行。
CROSS 行のすべての組み合わせ(条件は使用できません)。

クロス結合以外の各結合には、AND / ORで組み合わせた1つ以上の条件があり、演算子=、<>、<、<=、>、>=、BETWEEN、IS NULL、IS NOT NULL、IN、NOT IN、LIKE、NOT LIKEを使用できます。

条件では、Build PlantやCust (Id)のように、スペースや句読点を含む名前の列を指定できます。その列は、その入力に存在する必要があります。二重引用符、バッククォート、バックスラッシュ、制御文字を含む名前は拒否されます。

BETWEENでは、入力のエイリアス、ドット、列の順に書かれた境界(cust.Max Id)は、その入力の列として読み取られます。それ以外の境界はリテラルテキストとして扱われ、ドットのない単なるエイリアス名も同様です。そのため、入力にエイリアスcustがある場合のcust.2024のように、エイリアスとドットで始まるテキストの境界は、列として読み取られ、存在しないと報告されます。

列タブで、結果の列をマッピングします。必要に応じて、名前の変更、データ型の設定、集計を行います。同じ名前の列には、衝突を避けるために、ソースエイリアスが自動的にプレフィックスとして付けられます。

各行は、次の3つのフィールドのうちちょうど1つから値を取得します。複数を設定したり、何も設定しなかったりすると拒否されます。

種類 フィールド
ソース列 ソースエイリアス(その列を持つキャンバス上のエイリアス)とソース(alias.column)。どちらも必須です。
定数 定数 — すべての行で同じ固定値です。
式 式 — キャンバス上の任意のエイリアスをalias.columnとして参照できるSQLAlchemyの式です。
  • キャンバスから選択… — キャンバス上のすべてのソースの列からチェックを入れて選択します。
  • すべてのソース列を追加 — すべてのソースのすべての列を追加します。
  • 式の列を追加 — 式の行を追加し、式エディターを開きます。

Post-Join Filterタブは、結合結果が書き込まれる前に、任意のフィルター(SQLのHAVINGに相当)を適用します。同じ式エディターで編集します。出力列をresult.column_nameとして参照し、ソースエイリアスはここではスコープ外です。

実行時に指定された列も引き継ぐを選択すると、ステップが列挙していないすべてのソース列が、ステップの実行時にテーブルが持っているとおりに、そのまま渡されます。ピボットのように、データに応じて名前が決まる列を前のステップが作成するため、ステップの構築時にそれらを列挙できない場合に使用します。オフのままにすると、列挙した列だけが書き込まれます。

  • 結合グラフはツリーです。各テーブルはちょうど1つのエッジを通じて結果に結合され(循環なし)、テーブルを自分自身に結合することはできません。
  • 設定は、ステップの保存時と実行時の両方で検証されます。エラーがあると、問題のあるテーブルまたは結合に⚠マーカーが付き、保存に失敗すると最初の問題があるタブに切り替わり、問題へ移動でも、必要に応じてそこに移動できます。出力列の式とPost-Join Filterは保存時にチェックされます。実行時に指定された列を引き継ぐ結合では、保存時の式のチェックは省略され、ステップの実行時にチェックされます。

ステップの実行時

Table Extract、Table Lookup、Table Inner Join、Table Cross Join、Table Outer Join、Table Anti Join、複数テーブル結合、Table Union Distinct、Table Union All、Table Pivot、Table Melt、Table In-Place Delete、Table Upsert、Table Append の各ステップは、実行時、何かを書き込む前に、ソーステーブルを確認します。この確認では、ステップが構築したクエリを、その時点の各ソーステーブルと照合します。

  • ステップが読み取る列がテーブルにない場合、テーブルにない、またはステップのソース列にない結合キーがある場合、またはステップが読み取るソーステーブルが構築されていない場合、ステップは停止します。1つのエラーにすべての問題がそれぞれの修正方法とともに示されます。既存のターゲットテーブルは元の状態のまま残り、ステップが作成する必要があったターゲットテーブルは空のままになります。
  • ステップが一覧に載せているが読み取らない列がテーブルにもうない場合は、警告が追加されます。ステップはその列なしで実行されます。
  • Table Union Distinct と Table Union All は、構築されていないソーステーブルについては例外です。従来どおり、そのテーブルを警告なしで除外し、残りのテーブルをまとめます。ソーステーブルが1つも構築されていない場合は、失敗せずに警告を出して終了します。

ターゲットがビューであるステップはビューを作成するだけなので、一覧に載せている列と結合キーは、ウェアハウスがそのビューの作成を拒否する場合にのみ、そのテーブルと照合して確認されます。それ以外の場合は、構築されていないソーステーブル、またはステップの一覧にない結合キーがある場合にのみステップが停止し、警告は追加されません。

可能な場合、エラーにはテーブルを構築するステップが示され、テーブルに不足している列と名前が近い列(大文字小文字だけが異なる列など)がある場合は、その列も示されます。