match – função de script e gráfico

A função match compara o primeiro parâmetro com todos os seguintes e retorna a localização numérica das expressões correspondentes. A comparação faz distinção de maiúsculas e minúsculas.

Sintaxe:

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

Tipo de dados de retorno: inteiro

Se você quer usar comparação que não diferencia caracteres maiúsculos de minúsculos, use a função mixmatch. Se você quer usar comparação que não diferencia caracteres maiúsculos de minúsculos e "caracteres curingas", use a função wildmatch.

Argumentos
Argumento	Descrição
str	A string a ser avaliada.
expr1	A primeira expressão na qual se buscará uma representação numérica válida.
expr2	A segunda expressão na qual se buscará uma representação numérica válida.
expr3	A terceira expressão na qual se buscará uma representação numérica válida.

Exemplo: expressões de gráfico
Exemplo	Resultado
match( ColorCode,'Blue','Black' )	Essa expressão retorna o índice da correspondência com o campo ColorCode. Se o valor de ColorCode for Blue, então ele retornará 1. Se o valor de ColorCode for Black, então ele retornará 2. Se não for encontrada correspondência, será retornado 0.
match( Region, 'North', 'East' )	Essa expressão retorna o índice da correspondência com o campo Region. Se o valor de Region for North, então ele retornará 1. Se o valor de Region for East, então ele retornará 2. Se não for encontrada correspondência, será retornado 0.

Alguns dos exemplos neste tópico usam carregamentos inline. Para obter mais informações, consulte Usando carregamentos inline para carregar dados.

Exemplo – Categorizar os produtos usando match

Visão geral

Um conjunto de dados contém dados de produtos. Você deseja identificar e categorizar produtos que são consumíveis.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Os campos a seguir na tabela de dados:
- ProductID
- ProductName
- ProductCategory

Script de carregamento

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

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

ProductID
ProductName
ProductCategory

Crie as seguintes medidas:

=match(ProductCategory,'Toiletries', 'Fruits'), para retornar o índice em que ProductCategory tem o valor Toiletries ou Fruits.
=If(match(ProductCategory, 'Toiletries', 'Fruits'), 'Consumable', 'Other'), para retornar o índice em que ProductCategory tem o valor Toiletries ou Fruits. Se um dos dois for encontrado, Consumable será retornado. Caso contrário, Other será retornado.

Tabela de resultados
ProductID	ProductName	ProductCategory	match(ProductCategory,'Toiletries', 'Fruits')	If(match(ProductCategory, 'Toiletries', 'Fruits'), 'Consumable', 'Other')
1	Laptop	Electronics	0	Other
2	Banana	Fruits	2	Consumable
3	Shampoo	Toiletries	1	Consumable
4	TV	Electronics	0	Other
5	Apple	Fruits	2	Consumable

A função match retorna o índice dos caracteres de busca na primeira medida. Na segunda medida, esse resultado é usado em uma função If para categorizar os produtos como Consumable ou Other.

Exemplo – Avaliar e classificar os dados do cliente usando match

Visão geral

Um conjunto de dados contém dados de clientes. Você deseja identificar e categorizar os clientes cuja região e categoria de setor atendam aos seus requisitos de classificação.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Os campos a seguir na tabela de dados:
- ClientID
- ClientName
- Region
- Industry

Script de carregamento

Example:
LOAD * INLINE [
ClientID, ClientName, Region, Industry
1, "Acme Corp", "North", "Manufacturing"
2, "Beta Ltd", "East", "Technology"
3, "Gamma Inc", "West", "Retail"
4, "Delta LLC", "North", "Technology"
5, "Epsilon GmbH", "South", "Healthcare"
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

ClientID
ClientName
Region
Industry

Crie a seguinte medida:

=IF(match(Region, 'North', 'East') AND match(Industry, 'Technology', 'Manufacturing'), 'Target Segment', 'Secondary Segment'), para retornar o índice dos caracteres de busca. Se for encontrado, Target Segment será retornado. Se não for encontrado, Secondary Segment será retornado.

Tabela de resultados
ClientID	ClientName	Region	Industry	IF(match(Region, 'North', 'East') AND match(Industry, 'Technology', 'Manufacturing'), 'Target Segment', 'Secondary Segment')
1	Acme Corp	North	Manufacturing	Target Segment
2	Beta Ltd	East	Technology	Target Segment
3	Gamma Inc	West	Retail	Secondary Segment
4	Delta LLC	North	Technology	Target Segment
5	Epsilon GmbH	South	Healthcare	Secondary Segment

A função match pesquisa o texto e retorna um índice que pode ser usado para realizar análises adicionais e classificação de dados. Por exemplo, Acme Corp é classificado como um Target Segment porque atende aos requisitos de busca da função match para os campos Region e Industry.

Exemplo: Script de carregamento usando match

Visão geral

Você pode usar match para carregar um subconjunto de dados. Por exemplo, você pode retornar um valor numérico para uma expressão na função. Você pode, então, limitar os dados carregados com base no valor numérico. A função Match retorna 0 se não houver correspondência. Portanto, todas as expressões não correspondidas neste exemplo retornarão 0 e serão excluídas do carregamento de dados pelo comando WHERE.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em duas tabelas de dados chamadas:
- Transactions: inclui campos de transação
- Transaction_Buckets: cria dois novos campos: Customer e Color Code Blue and Black. O comando where carrega os resultados da função match.

Script de carregamento

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 Blue and Black
Load Transactions table.
Match returns 1 for 'Blue', 2 for 'Black'. 
Does not return a value for 'blue' because match is case sensitive.
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 Blue and Black]
Resident Transactions
Where match(color_code,'Blue','Black') > 0;

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

[Color Code Blue and Black]
Customer

Tabela de resultados mostrando a saída do uso da função match no script de carregamento
Color Code Blue and Black	Customer
Black	203521
Black	3036491
Blue	2038593

Exemplo – Expressão de gráfico usando match

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Os campos a seguir na tabela de dados:
- Cities
- Count

Script de carregamento

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];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

Cities

Crie as seguintes medidas:

=match( Cities,'Toronto','Boston','Beijing','Zurich'), para retornar o índice dos caracteres de busca.
=match( Cities,'Toronto','Boston','Beijing','Stockholm','zurich'), para retornar o índice dos caracteres de busca.
=Cities & ' - ' & match ( Cities, 'Toronto','Boston', 'Beijing','Stockholm','zurich'), para retornar o campo Cities e o índice dos caracteres de busca.

A primeira medida na tabela abaixo retorna 0 para Stockholm porque Stockholm não está incluído na lista de expressões na função match. Também retorna 0 para Zurich porque a comparação match diferencia maiúsculas de minúsculas.

Tabela de resultados
Cities	match( Cities,'Toronto','Boston','Beijing','Zurich')	match( Cities,'Toronto','Boston','Beijing','Stockholm','zurich')	Cities & ' - ' & match ( Cities, 'Toronto','Boston', 'Beijing','Stockholm','zurich')
Beijing	3	3	Beijing - 3
Boston	2	2	Boston - 2
Stockholm	0	4	Stockholm - 4
Toronto	1	1	Toronto - 1
zurich	0	5	zurich - 5

Exemplo – Expressão de classificação personalizada usando match

Visão geral

Você pode usar match para executar uma classificação personalizada para uma expressão. Este exemplo usa o mesmo conjunto de dados do exemplo anterior.

Por padrão, as colunas são classificadas numericamente ou alfabeticamente, dependendo dos dados.

Tabela de resultados mostrando a ordem de classificação padrão
Cities
Beijing
Boston
Stockholm
Toronto
zurich

Para alterar a ordem de classificação, faça o seguinte:

Abra a seção Classificação do gráfico no painel Propriedades.
Desative a classificação automática para a coluna na qual você deseja fazer uma classificação personalizada.
Desmarque as caixas de seleção Classificar numericamente e Classificar alfabeticamente.
Selecione Classificar por expressão e insira uma expressão semelhante à seguinte:

=match( Cities, 'Toronto','Boston','Beijing','Stockholm','zurich')

A ordem de classificação na coluna Cities é alterada.

Tabela de resultados mostrando a ordem de classificação usando a função match
Cities
Toronto
Boston
Beijing
Stockholm
zurich

Saiba mais

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui