lookup

Utilice el comando lookup para llamar a las consultas de valores de campo.

Sintaxis

lookup table=<lookupTable>[<lookup_options>] select <outputFields> using <inputFields>

Parámetros

En la siguiente tabla se muestran los parámetros utilizados en este comando, junto con sus descripciones.

Parámetro Descripción
outputFields

Sintaxis: <lookup_field> [as <log_field>] [,<lookup_field> [as <log_field>] ]*

Lista de uno o más campos de la tabla de consulta que se deben copiar en los campos de log coincidentes, indexados o virtuales.

lookupTable

Nombre de la tabla de consulta.

lookup options

Sintaxis: [maxmatches= <value>] [default=<value>]

maxmatches: número máximo de posibles coincidencias que se devolverán para una clave de consulta determinada. Se devuelven las n primeras coincidencias, en orden de archivo. Valores válidos: 1-1.000, ambos incluidos. El valor por defecto es 1.

default: el valor por defecto que se va a utilizar para todos los campos de salida no debe encontrarse una coincidencia para una clave de consulta especificada. Por defecto, es nulo.

inputFields

Sintaxis: <log_field> [= <lookup_field>] [,<log_field> [= <lookup_field>] ]*

Lista de uno o más campos de la tabla de consulta para que coincidan con los logs. El nombre de campo de log, indexado o virtual, se debe especificar si es diferente del nombre de campo de la consulta.

Para ver ejemplos del uso de este comando en escenarios habituales, consulte:

En el siguiente ejemplo se muestra cómo anotar los registros de log que contienen código de error ORA con la descripción y gravedad del error cuando los campos de consulta sean los nombres de los campos indexados existentes.

* | lookup table=OraErrorCodes select description as errtxt, severity as sevlvl using 'Error Id'=error_id

En el siguiente ejemplo se muestra cómo agregar información de grupos de usuarios que no incluya más de 5 grupos.

* | lookup table=UserGroups maxmatches=5 select group using usrid

En el siguiente ejemplo se muestra cómo anotar los registros de log con la información de varias consultas.

* | lookup table=DnsLookup select client_host using client_ip | lookup table=AccountLookup select acct_region using acct_id

En el siguiente ejemplo se muestra cómo realizar dos consultas utilizando la misma tabla de consulta, pero cada consulta se realiza con distintos campos.

* | lookup table=MyLookup select B using A | lookup table=MyLookup select D using C

En el siguiente ejemplo se muestra cómo buscar un valor en una tabla de consulta y, a continuación, utilizar un valor de campo devuelto para realizar una consulta con una segunda tabla de consulta.

* | lookup table=FirstLookup select Y using X | lookup table=SecondLookup select Z using Y