Referencia de sintaxis de Data Catalog Search
Azure Data Catalog es un servicio totalmente administrado hospedado en Microsoft Azure que actúa como sistema de registro y sistema de detección para orígenes de datos empresariales. Azure Data Catalog tiene funcionalidades que permiten a los usuarios técnicos y no técnicos detectar, comprender y consumir orígenes de datos.
Un aspecto clave de la detección de datos es la capacidad de buscar orígenes de datos registrados en Azure Data Catalog. Azure Data Catalog tiene una eficaz sintaxis de búsqueda que permite a los usuarios crear fácilmente consultas que devuelvan los datos que necesitan los usuarios.
Información general sobre la sintaxis de búsqueda
Las búsquedas de Azure Data Catalog son similares a las usadas por Microsoft Windows y Microsoft Outlook, y que deben estar familiarizados con los usuarios de estas herramientas.
Técnicas de consulta
| Técnica | Use | Ejemplo |
|---|---|---|
| Búsqueda básica | Búsqueda básica con uno o varios términos de búsqueda. Los resultados son los recursos que tienen alguna propiedad que coincide con uno o varios de los términos especificados. | sales data |
| Ámbito de propiedad | Devuelve solamente los orígenes de datos para los que el término de búsqueda coincide con la propiedad especificada | name:finance |
| Operadores booleanos | Se puede ampliar o reducir una búsqueda mediante operaciones booleanas | finance NOT corporate |
| Agrupación con paréntesis | Use paréntesis para agrupar partes de la consulta y así conseguir aislamiento lógico, especialmente en combinación con los operadores booleanos | name:finance AND (tags:tag1 OR tags:tag2) |
| Operadores de comparación | Use comparaciones distintas de la igualdad de propiedades que tengan tipos de datos numéricos y de fechas | creationTime>"11/05/2014" |
Operadores de coincidencia, comparación y booleanos
| Palabra clave/símbolo | Ejemplos | Función |
|---|---|---|
| : | experts:user@domain.com tags:tag1 |
Use el ámbito de la propiedad y devuelva solo los recursos en los que una propiedad determinada contiene el texto que se busca. La semántica de la consulta es "coincidencia de prefijo". |
| = | name=Sales name="Soft Drink Sales" |
Permite al usuario especificar una coincidencia exacta. Solo se devolverán los recursos que contienen la propiedad con exactamente el valor del término de búsqueda. |
| <> | experts<>user1 tags<>tag2 |
Operador "Not equal to". Devolverá solo los recursos que no tengan el valor indicado en la consulta de búsqueda. |
| "" | "social security" |
Busca elementos que contienen la frase exacta seguridad social. Hay un caso especial para usar comillas. Si se usan comillas con el ámbito de la propiedad, la semántica se agrupa, pero no la expresión exacta. En este caso, el comportamiento es el mismo que especificar la propiedad con nombre dos veces. Ejemplo: name:"social security" busca cualquier recurso que tenga una propiedad name con la palabra social en ella o una propiedad name con la palabra security en él. |
| () | (tags:tag1 AND tags:tag2) OR (name:sales AND database:salesfy15) |
Busca los elementos que contienen tag1 y tag2 o tienen el nombre sales in database salesfy15. Normalmente se usa junto con operadores booleanos |
| >,>= | timestamp>"11/05/2014" |
Busca elementos con una fecha de modificación después del 11/05/2014. |
| <,<= | timestamp<"11/05/2014" |
Busca elementos con una fecha anterior al 11/05/2014. |
| NOT | social NOT security |
Busca elementos que contienen elementos sociales, pero no seguridad. |
| y | social AND security |
Busca elementos que contienen seguridad social y social. |
| O BIEN | social OR security |
Busca elementos que contienen seguridad social o social. |
| tiene: | has:tags has:description |
Permite filtrar y devolver solo los recursos en los que se establece una propiedad determinada (o si la propiedad representa una colección, contiene al menos un elemento). |
Notas
Semántica de prefijo
De forma predeterminada, todas las búsquedas en Azure Data Catalog se realizan mediante una técnica denominada Prefix Match Semantics. Esto significa que cualquier término de búsqueda inicia una coincidencia al principio de las propiedades del recurso.
Por ejemplo, considere dos recursos ficticios registrados en Azure Data Catalog con los nombres siguientes:
- SalesData
- Presupuestos de salesman
Una búsqueda de "ventas" devuelve ambos recursos, ya que sus nombres comienzan por la palabra "sales". Las versiones futuras de Azure Data Catalog incluyen compatibilidad con operadores de coincidencia exactos.
Búsquedas con ámbito de propiedad
La gramática de consultas de Azure Data Catalog admite el ámbito de las propiedades. En la versión preliminar actual, los ámbitos de propiedad distinguen mayúsculas de minúsculas. Esto significa que, para que la consulta funcione, las mayúsculas y minúsculas reales de la propiedad de la consulta de búsqueda deben coincidir con lo que se encuentra en el índice.
Las búsquedas en propiedades no válidas (propiedades que no existen) producen un error.
Las comillas se comportan de forma especial cuando se usa el ámbito de propiedades. Las comillas de cualquier otro contexto indican expresiones exactas. Sin embargo, cuando se usan comillas en el ámbito de la propiedad, la semántica se agrupa. Por ejemplo, name:"Sales Products" realiza una búsqueda de texto libre en el contenido de la propiedad name que busca "Sales" o "Products". Por lo tanto, la semántica de: name:"Sales Products" es exactamente la misma que name:Sales name:Products.
El principio general de los nombres de propiedad en Propiedades que se pueden buscar es camel-case, lo que significa que la primera letra es minúscula y, a continuación, cada una de las primeras letras de la palabra está en mayúsculas.
A continuación se enumeran las propiedades más útiles.
| Propiedad | Use | Ejemplo |
|---|---|---|
| name | Busca elementos en los que aparece el término de búsqueda en el nombre del origen de datos. | name:finance |
| description | Busca elementos en los que aparece el término de búsqueda en la descripción del origen de datos. | description:finance |
| objectType | Busca elementos de un tipo de objeto específico, como tabla, vista o KPI. | objectType:table |
| sourceType | Busca elementos de un tipo de origen de datos específico, como SQL Server o SQL Server Analysis Services Multidimensional. | sourceType:"tabular" |
| etiquetas | Busca elementos en los que aparece el término de búsqueda en las etiquetas del origen de datos. | tags:finance |
| timestamp | Busca elementos basados en la fecha y hora en que se modificaron los metadatos más recientemente. | timestamp:>"11/05/2014" |
| lastRegisteredTime | Busca elementos basados en la fecha y hora en que se registraron sus metadatos. | lastRegisteredTime:>"11/05/2014" |
| friendlyName | Busca elementos en los que el término de búsqueda aparece en el nombre descriptivo del origen de datos. | friendlyName: finance |
| Expertos | Busca elementos en los que el experto en el origen de datos coincide con el término de búsqueda. | experts:user@example.com experts:user |
| termName | Busca elementos en los que el término de búsqueda aparece en los términos del glosario empresarial aplicados al recurso de datos. | termName:marketing |
También puede usar los siguientes nombres de propiedad junto con el filtro "has:" para comprobar dónde están establecidos los recursos.
| Propiedad | Use | Ejemplo |
|---|---|---|
| Vistas previas | Busca elementos que contienen una vista previa | has:preview |
| en línea | Busca elementos que contienen documentación. | has:documentation |
| tableDataProfiles | Busca elementos que tienen un perfil de tabla (tamaño, número de filas, etc.) | has:tableDataProfiles |
| columnsDataProfiles | Busca elementos que tienen un perfil de datos de columna (número de valores distintos, min, max, etc.) | has:columnsDataProfiles |
Ejemplos de búsqueda
En las secciones siguientes se muestran algunos ejemplos de búsqueda.
Devolver todos los recursos con "ventas" en el nombre
name:sales
Devolver todos los activos registrados después del 20/4/2015 que incluyan "ventas" en cualquier propiedad
sales AND lastRegisteredTime>"4/20/2015"
Devuelve todos los recursos que incluyen ventas en cualquier propiedad y que no tienen la etiqueta Q1FY2013.
sales AND tags<>"Q1FY2013"
Devolver todos los recursos que no tienen expertos ni documentación asignada
not has:experts and not has:documentation