メインコンテンツまでスキップ

Table.FuzzyNestedJoin

指定された列でテーブルのあいまい結合を実行し、結合の結果を新しい列に生成します。

Syntax

Table.FuzzyNestedJoin(
table1 as table,
key1 as any,
table2 as table,
key2 as any,
newColumnName as text,
optional joinKind as JoinKind.Type,
optional joinOptions as record
) as table

Remarks

table1 の行と table2 の行を、(table1 の) key1 と (table2 の) key2 で選択されたキー列の値のあいまい一致に基づいて結合します。結果は newColumnName という名前の新しい列に返されます。
あいまい一致は、テキストの同一性ではなくテキストの類似性に基づく比較です。
省略可能な joinKind は、実行する結合の種類を指定します。joinKind を指定しなかった場合、既定では、左外部結合が実行されます。オプションは次のとおりです。

  • JoinKind.Inner
  • JoinKind.LeftOuter
  • JoinKind.RightOuter
  • JoinKind.FullOuter
  • JoinKind.LeftAnti
  • JoinKind.RightAnti

joinOptions の省略可能な設定を含めると、キー列の比較方法を指定できます。オプションは次のとおりです。
  • ConcurrentRequests : あいまい一致に使用するパラレル スレッドの数を指定する、1 - 8 の数値です。既定値は 1 です。
  • Culture : カルチャ固有のルールに基づくレコードの照合を許可します。任意の有効なカルチャ名を指定できます。たとえば、"ja-JP" のカルチャ オプションは、日本語カルチャに基づいてレコードを照合します。既定値は "" で、英語のインバリアント カルチャに基づいて照合します。
  • IgnoreCase : 大文字と小文字を区別しないキーの照合を許可する論理値 (true/false) です。true の場合、たとえば "Grapes" は "grapes" と一致します。既定値は true です。
  • IgnoreSpace : 一致を検索するために、テキストの一部の結合を許可する論理値 (true/false) です。true の場合、たとえば "Gra pes" は "Grapes" と一致します。既定値は true です。
  • NumberOfMatches : 各入力行で返すことができる、一致する行の最大数を指定する整数です。たとえば値が 1 の場合、各入力行に対して最大で 1 つの一致する行が返されます。このオプションが指定されていない場合、すべての一致する行が返されます。
  • SimilarityColumnName : 入力値とその入力の代表的な値の間の類似性を示す列の名前です。既定値は null で、類似性の新しい列は追加されません。
  • Threshold : 2 つの値が一致する類似度スコアを指定する、0.00 - 1.00 の数値です。 たとえば、このオプションが 0.90 未満に設定されている場合、"Grapes" と "Graes" ("p" がない) は一致します。 しきい値 1.00 は、完全一致の場合のみ許可されます。 (あいまいな「完全一致」は、大文字/小文字の指定、文字の順序、句読点などの違いを無視する場合があることに注意してください。) 既定値は 0.80 です。
  • TransformationTable : カスタム値のマッピングに基づくレコードの照合を許可するテーブルです。"From" 列と "To" 列が含まれている必要があります。たとえば、"From" 列に "Grapes"、"To" 列に "Raisins" が含まれる変換テーブルが指定されている場合、"Grapes" は "Raisins" と一致します。変換は、変換テーブルに含まれるテキストの出現すべてに対して適用されることにご注意ください。上述の変換テーブルの場合、"Grapes are sweet" も "Raisins are sweet" と一致します。

Examples

Example #1

[FirstName] に基づく 2 つのテーブルの左内部あいまい結合

Table.FuzzyNestedJoin(
Table.FromRecords(
{
[CustomerID = 1, FirstName1 = "Bob", Phone = "555-1234"],
[CustomerID = 2, FirstName1 = "Robert", Phone = "555-4567"]
},
type table [CustomerID = nullable number, FirstName1 = nullable text, Phone = nullable text]
),
{"FirstName1"},
Table.FromRecords(
{
[CustomerStateID = 1, FirstName2 = "Bob", State = "TX"],
[CustomerStateID = 2, FirstName2 = "bOB", State = "CA"]
},
type table [CustomerStateID = nullable number, FirstName2 = nullable text, State = nullable text]
),
{"FirstName2"},
"NestedTable",
JoinKind.LeftOuter,
[IgnoreCase = true, IgnoreSpace = false]
)

Result:

Table.FromRecords({
[
CustomerID = 1,
FirstName1 = "Bob",
Phone = "555-1234",
NestedTable = Table.FromRecords({
[
CustomerStateID = 1,
FirstName2 = "Bob",
State = "TX"
],
[
CustomerStateID = 2,
FirstName2 = "bOB",
State = "CA"
]
})
],
[
CustomerID = 2,
FirstName1 = "Robert",
Phone = "555-4567",
NestedTable = Table.FromRecords({})
]
})

Category

Table.Transformation