Sintaxe, parâmetros e exemplos de funções de tabela.
Funções
|
Categoria |
Função |
Descrição |
|
Texto para tabela |
Cria uma tabela a partir de texto no formato CSV. |
|
|
Tabela para dicionário |
Gera um dicionário com base em uma tabela. |
tab_parse_csv
Cria uma tabela a partir de texto no formato CSV.
-
Sintaxe
tab_parse_csv( data, sep=',', quote='"', lstrip=True, headers=None, case_insensitive=True, primary_keys=None, ) -
Parâmetros
Nome do parâmetro
Tipo de dados
Obrigatório
Descrição
data
String
Sim
Texto no formato CSV.
sep
String
Não
Separador do formato CSV. Valor padrão: vírgula (,).
quote
String
Não
Caractere de aspas. Se um valor contiver o separador, coloque-o entre aspas. Valor padrão: aspas duplas (").
lstrip
Booleano
Não
Remove espaços à esquerda de cada palavra-chave. Valor padrão: True.
headers
String, Lista de strings
Não
Nomes de cabeçalho para cada campo analisado. Por padrão, os cabeçalhos são lidos da primeira linha. Caso a primeira linha contenha dados em vez de cabeçalhos, especifique-os neste parâmetro.
case_insensitive
Booleano
Não
Ignora maiúsculas e minúsculas na correspondência. Valor padrão: True.
primary_keys
String, Lista de strings
Não
Chave primária nos data.
Após definir este parâmetro, ao usar uma função de enriquecimento de mapeamento, o campo especificado no parâmetro field da função deve corresponder a esta chave primária. Para mais informações sobre funções de enriquecimento de mapeamento, consulte Funções de enriquecimento de mapeamento.
-
Resposta
Retorna os dados da tabela mapeada.
-
Exemplos
-
Exemplo 1: Criar uma tabela e mapear o valor de um campo.
-
Log bruto
city:nanjing -
Regra de transformação
e_table_map( tab_parse_csv( "province,city,pop,gdp\nshanghai,shanghai,2000,1000\njiangsu,nanjing,800,500" ), "city", "province", ) -
Resultado
city:nanjing province:jiangsu
-
-
Exemplo 2: Criar uma tabela e mapear valores de vários campos.
-
Log bruto
city:nanjing province:jiangsu -
Regra de transformação
e_table_map( tab_parse_csv( "province,city,pop,gdp\nshanghai,shanghai,2000,1000\njiangsu,nanjing,800,500" ), ["province", "city"], ["pop", "gdp"], ) -
Resultado
city:nanjing gdp:500 pop:800 province:jiangsu
-
-
Exemplo 3: Mapear campos cujos nomes diferem dos nomes das colunas da tabela. Em cada tupla de campo de origem, o primeiro elemento é o campo de origem e o segundo é o campo da tabela. Em cada tupla de campo de destino, o primeiro elemento é o campo da tabela e o segundo é o novo campo.
-
Log bruto
city:nanjing province:jiangsu -
Regra de transformação
e_table_map( tab_parse_csv( "prov,city,pop,gdp\nshanghai,shanghai,2000,1000\njiangsu,nanjing,800,500" ), [("province", "prov"), "city"], [("pop", "population"), ("gdp", "GDP")], ) -
Resultado
GDP:500 city:nanjing population:800 province:jiangsu
-
-
Exemplo 4: Mapear campos com nomes diferentes das colunas da tabela e chaves primárias especificadas. Na tupla de campo de origem, o primeiro elemento representa o campo de origem e o segundo, o campo da tabela. Na tupla de campo de destino, o primeiro elemento corresponde ao campo da tabela e o segundo, ao novo campo. O campo da tabela na tupla de origem deve coincidir com a chave primária.
-
Log bruto
city:nanjing province:jiangsu -
Regra de transformação
e_table_map( tab_parse_csv( "prov,city,pop,gdp\nshanghai,shanghai,2000,1000\njiangsu,nanjing,800,500", primary_keys=["prov", "city"], ), [("province", "prov"), "city"], [("pop", "population"), ("gdp", "GDP")], ) -
Resultado
GDP:500 city:nanjing population:800 province:jiangsu
-
-
tab_to_dict
Gera um dicionário com base em uma tabela.
-
Sintaxe
tab_to_dict(table, key_field, value_field, key_join=",", value_join=",") -
Parâmetros
Nome do parâmetro
Tipo de dados
Obrigatório
Descrição
table
table
Sim
Dados da tabela.
key_field
String, Lista de strings
Sim
Coluna ou colunas da tabela usadas para construir as chaves do dicionário. Ao especificar várias colunas, elas são unidas pela string definida em
key_join.value_field
String, Lista de strings
Sim
Coluna ou colunas da tabela usadas para compor os valores do dicionário. Se houver várias colunas, elas são unidas pela string indicada em
value_join.key_join
String
Não
String usada para unir várias colunas e formar uma chave. Valor padrão: vírgula (,).
value_join
String
Não
String usada para unir várias colunas e formar um valor. Valor padrão: vírgula (,).
-
Resposta
Retorna os dados do dicionário mapeado.
-
Exemplos
-
Exemplo 1
-
Log bruto
k1:v1 city:nj -
Regra de transformação
e_dict_map( tab_to_dict(tab_parse_csv("city,pop\nsh,2000\nnj,800"), "city", "pop"), "city", "popu", ) -
Resultado
k1:v1 city:nj popu:800
-
-
Exemplo 2
-
Log bruto
k1:v1 city:js,nj -
Regra de transformação
e_dict_map( tab_to_dict( tab_parse_csv("province,city,pop\nsh,sh,2000\njs,nj,800"), ["province", "city"], "pop", ), "city", "popu", ) -
Resultado
k1:v1 city:js,nj popu:800
-
-