Sintaxis, parámetros y ejemplos de las funciones de tabla.
Funciones
|
Categoría |
Función |
Descripción |
|
Texto a tabla |
Construye una tabla a partir de texto en formato CSV. |
|
|
Tabla a diccionario |
Construye un diccionario a partir de una tabla. |
tab_parse_csv
Construye una tabla a partir de texto en formato CSV.
-
Sintaxis
tab_parse_csv( data, sep=',', quote='"', lstrip=True, headers=None, case_insensitive=True, primary_keys=None, ) -
Parámetros
Nombre del parámetro
Tipo de dato
Obligatorio
Descripción
data
String
Sí
El texto en formato CSV.
sep
String
No
El separador para el formato CSV. El valor predeterminado es la coma (,).
quote
String
No
El carácter de comillas. Si un valor contiene el separador, debe encerrar el valor entre comillas. El valor predeterminado son las comillas dobles (").
lstrip
Boolean
No
Indica si se eliminan los espacios iniciales de cada palabra clave. Valor predeterminado: True.
headers
String, String List
No
Los nombres de encabezado para cada campo analizado. De forma predeterminada, los encabezados se leen de la primera fila. Si la primera fila contiene datos en lugar de encabezados, especifique los encabezados mediante este parámetro.
case_insensitive
Boolean
No
Indica si la coincidencia no distingue entre mayúsculas y minúsculas. Valor predeterminado: True.
primary_keys
String, String List
No
La clave principal en data.
Después de establecer este parámetro, si utiliza una función de enriquecimiento de asignación, el campo especificado en el parámetro field de la función debe ser igual a esta clave principal. Para obtener más información sobre las funciones de enriquecimiento de asignación, consulte Mapping enrichment functions.
-
Respuesta
Devuelve los datos de la tabla asignada.
-
Ejemplos
-
Ejemplo 1: Construir una tabla y asignar el valor de un campo.
-
Registro sin procesar
city:nanjing -
Regla de transformación
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
-
-
Ejemplo 2: Construir una tabla y asignar los valores de varios campos.
-
Registro sin procesar
city:nanjing province:jiangsu -
Regla de transformación
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
-
-
Ejemplo 3: Asignar campos con nombres distintos a los de las columnas de la tabla. En cada tupla de campo de origen, el primer elemento es el campo de origen y el segundo es el campo de la tabla. En cada tupla de campo de destino, el primer elemento es el campo de la tabla y el segundo es el nuevo campo.
-
Registro sin procesar
city:nanjing province:jiangsu -
Regla de transformación
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
-
-
Ejemplo 4: Asignar campos con nombres distintos a los de las columnas de la tabla, con claves principales especificadas. En cada tupla de campo de origen, el primer elemento es el campo de origen y el segundo es el campo de la tabla. En cada tupla de campo de destino, el primer elemento es el campo de la tabla y el segundo es el nuevo campo. El campo de la tabla en la tupla de campo de origen debe coincidir con la clave principal.
-
Registro sin procesar
city:nanjing province:jiangsu -
Regla de transformación
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
Construye un diccionario a partir de una tabla.
-
Sintaxis
tab_to_dict(table, key_field, value_field, key_join=",", value_join=",") -
Parámetros
Nombre del parámetro
Tipo de dato
Obligatorio
Descripción
table
table
Sí
Los datos de la tabla.
key_field
String, String List
Sí
La columna o columnas de la tabla que se utilizan para construir las claves del diccionario. Si especifica varias columnas, estas se unen mediante la cadena indicada en
key_join.value_field
String, String List
Sí
La columna o columnas de la tabla que se utilizan para construir los valores del diccionario. Si especifica varias columnas, estas se unen mediante la cadena indicada en
value_join.key_join
String
No
La cadena que se usa para unir varias columnas y formar una clave. El valor predeterminado es la coma (,).
value_join
String
No
La cadena que se usa para unir varias columnas y formar un valor. El valor predeterminado es la coma (,).
-
Respuesta
Devuelve los datos del diccionario asignado.
-
Ejemplos
-
Ejemplo 1
-
Registro sin procesar
k1:v1 city:nj -
Regla de transformación
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
-
-
Ejemplo 2
-
Registro sin procesar
k1:v1 city:js,nj -
Regla de transformación
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
-
-