wildmatch - スクリプトおよびチャート関数

wildmatch 関数は、最初のパラメーターとそれに続くすべてのパラメーターを比較し、一致した数式の数を返します。比較文字列でワイルドカード文字 ( * および ?) を使用できます。 * は任意の文字のシーケンスと一致します。? は任意の 1 文字と一致します。比較では大文字と小文字は区別されず、日本語のひらがなとカタカナも区別されません。

構文:

wildmatch( str, expr1 [ , expr2,...exprN ])

戻り値データ型：整数

ワイルドカードを使用せずに比較を行う場合は、match 関数または mixmatch 関数を使用します。

引数
引数	説明
str	評価される文字列。
expr1	有効な数値表現を確認する最初の数式。
expr2	有効な数値表現を確認する 2 番目の数式。
expr3	有効な数値表現を確認する 3 番目の数式。

例: チャートの数式
例	結果
wildmatch( ColorCode,'black','Blue' )	この数式は、ColorCode の値が Black の場合は 1 を返し、ColorCode の値が Blue、Light Blue、または blue の場合は 2 を返します。
wildmatch( Cities,'toronto','Boston','Beijing','Zurich')	この数式は、Cities 項目の値と一致するアイテムのインデックスを返します。

このトピックの例のいくつかは、インラインロードを使用しています。詳細については、「インラインロードを使用したデータのロード」を参照してください。

例 - wildmatch を使用して製品を分類する

概要

データセットには製品データが含まれています。消耗品である製品を識別し、分類しようとしています。

データロードエディターを開き、以下のロードスクリプトを新しいセクションに追加します。

ロードスクリプトには次が含まれています:

「Example」というデータテーブルにロードされるデータセット。
データテーブル内の次の項目:
- ProductID
- ProductName
- ProductCategory

ロードスクリプト

Example:
LOAD * INLINE [
ProductID, ProductName, ProductCategory
1, "Laptop", "Electronics"
2, "Banana", "fruit"
3, "Shampoo", "toiletries"
4, "TV", "Electronics"
5, "Apple", "Fruits and vegetables"
];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

ProductID
ProductName
ProductCategory

次のメジャーを作成します:

=wildmatch(ProductCategory, 'Toiletries*', 'Fruit*')、ProductCategory が Toiletries で始まる値または Fruit で始まる値を持つインデックスを返します。
=If(wildmatch(ProductCategory, 'Toiletries*', 'Fruit*'), 'Consumable', 'Other')、ProductCategory が Toiletries で始まる値または Fruits で始まる値を持つインデックスを返します。どちらかが見つかった場合は、Consumable が返されます。見つからなかった場合は、Other が返されます。

wildmatch 関数は、一致が見つかった場合はゼロ以外の正の値を返し、一致が見つからなかった場合はゼロを返します。if ステートメントは、ゼロ以外の結果を true として解釈し、ゼロを false として解釈します。if ステートメントを mixmatch、wildmatch、または match 関数と組み合わせることで、一致と不一致を簡単にデコードできます。

結果テーブル
ProductID	ProductName	ProductCategory	wildmatch(ProductCategory, 'Toiletries', 'Fruit')	If(wildmatch(ProductCategory, 'Toiletries', 'Fruit')
1	Laptop	Electronics	0	Other
2	Banana	fruit	2	Consumable
3	Shampoo	toiletries	1	Consumable
4	TV	Electronics	0	Other
5	Apple	Fruits and vegetables	2	Consumable

wildmatch 関数は、最初のメジャー内の検索文字列のインデックスを返します。2 番目のメジャーでは、この結果が If 関数で使用され、カスタム結果が提供されます。wildmatch 関数は大文字と小文字を区別せず、ワイルドカード文字 (* と ?) を使用できます。

例 - wildmatch を使用してクライアントデータを評価および分類する

概要

データセットにはクライアントデータが含まれています。地域と業種カテゴリが分類要件を満たすクライアントを特定し、分類しようとしています。

データロードエディターを開き、以下のロードスクリプトを新しいセクションに追加します。

ロードスクリプトには次が含まれています:

「Example」というデータテーブルにロードされるデータセット。
データテーブル内の次の項目:
- ClientID
- ClientName
- Region
- Industry

ロードスクリプト

Example:
LOAD * INLINE [ 
ClientID, ClientName, Region, Industry 
1, "Acme Corp", "north territory", "Vehicle Manufacturing" 
2, "Beta Ltd", "East location", "Science & Technology" 
3, "Gamma Inc", "west", "Retail Sales" 
4, "Delta LLC", "North", "Technology" 
5, "Epsilon GmbH", "South", "healthcare" 
];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

ClientID
ClientName
Region
Industry

次のメジャーを作成します:

=If(wildmatch(Region, 'North*', 'East*') AND wildmatch(Industry, '*Technology*', '*Manufacturing*'), 'Target Segment', 'Secondary Segment')、検索文字列のインデックスを返します。見つかった場合は、Target Segment が返されます。見つからなった場合は、Secondary Segment が返されます。

結果テーブル
ClientID	ClientName	Region	Industry	If(wildmatch(Region, 'North', 'East') AND wildmatch(Industry, 'Technology', 'Manufacturing'), 'Target Segment', 'Secondary Segment')
1	Acme Corp	north territory	Vehicle Manufacturing	Target Segment
2	Beta Ltd	East location	Science & Technology	Target Segment
3	Gamma Inc	west	Retail Sales	Secondary Segment
4	Delta LLC	North	Technology	Target Segment
5	Epsilon GmbH	South	healthcare	Secondary Segment

wildmatch 関数はテキストを検索し、追加の分析やデータ分類を実行するために使用できるインデックスを返します。例えば、Acme Corp は、Region と Industry の両方の項目について、wildmatch 関数の検索条件を満たしているため、Target Segment として分類されます。wildmatch 関数は大文字と小文字を区別せず、ワイルドカード文字 (* と ?) を使用できます。

例: wildmatch を使用したロードスクリプト

概要

wildmatch を使用してデータのサブセットをロードできます。たとえば、関数内の数式の数値を返すことができます。次に、その数値に基づいてロードされるデータを制限できます。一致がない場合、Wildmatch は 0 を返します。したがって、この例で一致しないすべての数式は 0 を返し、WHERE ステートメントによるデータロードから除外されます。

データロードエディターを開き、以下のロードスクリプトを新しいセクションに追加します。

ロードスクリプトには次が含まれています:

2 つのデータテーブルにロードされるデータセットは、次のように呼ばれます。
- Transactions: トランザクション項目を含みます
- Transaction_Buckets: 2 つの新しい項目 Customer と Color code - Black, Blue, blue, red を作成します。where ステートメントは、wildmatch 関数から結果をロードします。

ロードスクリプト

Transactions:
Load * Inline [
transaction_id, transaction_date, transaction_amount, transaction_quantity, customer_id, size, color_code
3750, 20180830, 23.56, 2, 2038593, L, Red
3751, 20180907, 556.31, 6, 203521, m, orange
3752, 20180916, 5.75, 1, 5646471, S, blue
3753, 20180922, 125.00, 7, 3036491, l, Black
3754, 20180922, 484.21, 13, 049681, xs, Red
3756, 20180922, 59.18, 2, 2038593, M, Blue
3757, 20180923, 177.42, 21, 203521, XL, Black
];
 
/*
Create new table called Transaction_Buckets
Create new fields called Customer, and Color code - Black, Blue, blue, red
Load Transactions table.
Wildmatch returns 1 for 'Black', 'Blue', and 'blue', and 2 for 'Red'. 
Only values that returned numeric value greater than 0 
are loaded by WHERE statement into Transactions_Buckets table.
*/
 
Transaction_Buckets:
Load
   customer_id,
   customer_id as [Customer],
   color_code as [Color Code Black, Blue, blue, Red]
Resident Transactions
Where wildmatch(color_code,'Bl*','R??') > 0;

結果

データをロードしてシートを開きます。新しいテーブルを作成し、これらの項目を軸として追加します:

[Color code - Black, Blue, blue, red]
Customer

ロードスクリプトで wildmatch 関数を使用した出力を示す結果テーブル。
Color code - Black, Blue, blue, red	Customer
Black	203521
Black	3036491
Blue	2038593
blue	5646471
Red	049681
Red	2038593

例: wildmatch を使用したチャートの数式

概要

データロードエディターを開き、以下のロードスクリプトを新しいセクションに追加します。

ロードスクリプトには次が含まれています:

「Example」というデータテーブルにロードされるデータセット。
データテーブル内の次の項目:
- Cities
- Count

ロードスクリプト

Example:
Load * inline [Cities, Count
Toronto, 123
Toronto, 234
Toronto, 231
Boston, 32
Boston, 23
Boston, 1341
Beijing, 234
Beijing, 45
Beijing, 235
Stockholm, 938
Stockholm, 39
Stockholm, 189
zurich, 2342
zurich, 9033
zurich, 0039];

結果

データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します:

Cities

次のメジャーを作成します:

=wildmatch( Cities,'Tor*','?ton','Beijing','*urich') 、検索文字列のインデックスを返します。
=wildmatch( Cities,'Tor*','???ton','Beijing','Stockholm','*urich')、検索文字列のインデックスを返します。
=Cities & ' - ' & wildmatch ( Cities, 'Tor*','???ton','Beijing','Stockholm','*urich')、Cities 項目と検索文字列のインデックスを返します。

以下のテーブルの最初のメジャーは、Stockholm が wildmatch 関数の式のリストに含まれていないため、Stockholm に対して 0 を返します。また、? は 1 つの文字にのみ一致するため、Boston に対して 0 が返されます。

結果テーブル
Cities	wildmatch( Cities,'Tor','?ton','Beijing','urich')	wildmatch( Cities,'Tor','???ton','Beijing','Stockholm','urich')	Cities & ' - ' & wildmatch ( Cities, 'Tor','???ton','Beijing','Stockholm','urich')
Beijing	3	3	Beijing - 3
Boston	0	2	Boston - 2
Stockholm	0	4	Stockholm - 4
Toronto	1	1	Toronto - 1
zurich	4	5	zurich - 5

例: wildmatch を使用したカスタムソート数式

概要

wildmatch を使用して、1 つの数式のカスタムソートを実行できます。この例では、前の例と同じデータセットを使用します。

既定では、データに応じて、列が数値またはアルファベット順にソートされます。

結果

データをロードしてシートを開きます。新しいテーブルを作成し、この項目を軸として追加します:

Cities

既定の並べ替え順序を示す結果テーブル
Cities
Beijing
Boston
Stockholm
Toronto
zurich

並べ替え順序を変更するには、次の手順を実行します。

プロパティパネルで、グラフの [ソート] セクションを開きます。
カスタムソートを適用する列の自動ソートをオフにします。
[数値によるソート] および [アルファベット順でソート] チェックボックスをオフにします。
[数式によるソート] を選択し、次に似た数式を入力します。

=wildmatch( Cities, 'Tor*','???ton','Beijing','Stockholm','*urich')

Cities 列のソート順序が変更されます。

wildmatch 関数を使用したソート順を示す結果テーブル
Cities
Toronto
Boston
Beijing
Stockholm
zurich

詳細を見る

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください

wildmatch - スクリプトおよびチャート関数

例 - wildmatch を使用して製品を分類する

例 - wildmatch を使用してクライアント データを評価および分類する

例: wildmatch を使用したロード スクリプト

例: wildmatch を使用したチャートの数式

例: wildmatch を使用したカスタム ソート数式

詳細を見る

このページは役に立ちましたか?

例 - wildmatch を使用してクライアントデータを評価および分類する

例: wildmatch を使用したロードスクリプト

例: wildmatch を使用したカスタムソート数式