Este documento descreve a sintaxe das consultas de pesquisa do Dataplex. Antes de ler este documento, é importante entender os conceitos do Dataplex Catalog, como entradas de dados, aspectos, tipos de aspecto, grupos de entrada e tipos de entrada. Para mais informações, consulte Visão geral do catálogo do Dataplex.
Para iniciar uma consulta de pesquisa do Dataplex Catalog no console do Google Cloud, acesse a página Pesquisa do Dataplex e selecione Dataplex Catalog como modo de pesquisa.
Para mais informações, consulte Pesquisar recursos de dados no catálogo do Dataplex (em inglês).
Pesquisa simples
Na forma mais simples, uma consulta de pesquisa do Dataplex Catalog consiste em um único predicado. Esse predicado pode corresponder a várias partes de metadados:
- Uma substring de um nome, nome de exibição ou descrição de um recurso de dados
- Uma substring do tipo de um recurso de dados
- Uma substring de um nome de coluna (ou nome de coluna aninhada) no esquema de um recurso de dados.
- Uma substring de um ID do projeto
- String de uma descrição geral
Por exemplo, o predicado foo
corresponde às seguintes entidades:
- Recurso de dados com o nome
foo.bar
- Recurso de dados com o nome de exibição
Foo Bar
- Recurso de dados com a descrição
This is the foo script
- Recurso de dados com o tipo exato
foo
- Coluna
foo_bar
no esquema de um recurso de dados - Coluna aninhada
foo_bar
no esquema de um recurso de dados - Projeto
prod-foo-bar
- Recurso de dados com uma visão geral que contém a palavra
foo
Predicados qualificados
Você pode qualificar um predicado usando um prefixo com uma chave que restringe a correspondência a uma parte específica dos metadados:
- Um sinal de igual (
=
) restringe a pesquisa a uma correspondência exata. - Dois pontos (
:
) após a chave corresponde ao predicado em um substring ou um token dentro do valor nos resultados da pesquisa.
A tokenização divide o fluxo de texto em uma série de tokens, cada um geralmente correspondente a uma palavra.
Exemplo:
name:foo
seleciona entidades com nomes que contêm a substringfoo
, comofoo1
ebarfoo
.description:foo
seleciona entidades com o tokenfoo
na descrição. comobar
efoo
.location=foo
faz a correspondência entre recursos de dados em um local especificado comfoo
como o nome do local.
As chaves de predicado type
, system
, location
e orgid
aceitam apenas o
qualificador de correspondência exata (=
), não o qualificador de substring (:
). Por exemplo:
type=foo
ou orgid=number
.
O Dataplex Catalog oferece suporte aos seguintes qualificadores:
Qualificador | Descrição |
---|---|
name:x |
Corresponde a x como substring do ID do recurso de dados. |
displayname:x |
Corresponda x como substring do nome de exibição do recurso de dados. |
column:x |
Corresponde a x como uma substring do nome da coluna (ou aninhadas).
nome da coluna) no esquema do recurso de dados. |
description:x |
Corresponde x como um token na descrição do recurso de dados. |
label:bar |
Corresponde a recursos de dados do BigQuery que têm um rótulo (com algum
valor) e a chave de rótulo tem bar como substring. |
label=bar |
Corresponde aos recursos de dados do BigQuery que têm um rótulo (com
algum valor), e a chave de rótulo é igual a bar como uma string. |
label:bar:x |
Corresponde a x como uma substring no valor de um rótulo com
a chave bar anexada a um recurso de dados do BigQuery. |
label=foo:bar |
Corresponde a recursos de dados do BigQuery em que a chave é igual a foo e o valor da chave é igual a bar . |
label.foo=bar |
Corresponde aos recursos de dados do BigQuery em que a chave é igual a
foo e o valor da chave é igual a bar . |
label.foo |
Corresponde a recursos de dados do BigQuery que têm um rótulo com uma chave igual a foo como uma string. |
type=TYPE |
Corresponde a ativos de dados de um tipo de entrada específico ou do alias do tipo. |
projectid:bar |
Corresponde recursos de dados em projetos do Google Cloud que correspondem a
bar como substring no ID. |
parent:x |
Corresponde a x como uma substring do caminho hierárquico de um recurso de dados. O caminho pai é um fully_qualified_name de
o recurso pai. |
orgid=number |
Faz a correspondência entre recursos de dados de uma organização do Google Cloud
o valor exato do ID de number . |
system=SYSTEM |
Corresponde recursos de dados de um sistema especificado. |
location=LOCATION |
Faz a correspondência entre recursos de dados em um local especificado com um nome exato.
Por exemplo, Os recursos BigQuery Omni aceitam esse qualificador usando o
Nome do local do BigQuery Omni.
Por exemplo,
|
createtime |
Encontra recursos de dados criados em, antes ou depois de uma determinada data ou hora. Exemplo:
Formato do carimbo de data/hora: Todos os carimbos de data/hora precisam estar no fuso horário GMT. fusos horários não são compatíveis. Parcial
carimbos de data/hora, separadores de data com hífen ( Exemplo:
|
updatetime |
Encontra recursos de dados que foram atualizados dentro, antes ou depois de um determinado data ou hora. Exemplo:
Formato do carimbo de data/hora: Todos os carimbos de data/hora precisam estar no fuso horário GMT. fusos horários não são compatíveis. Parcial
carimbos de data/hora, separadores de data com hífen ( Exemplo:
|
fully_qualified_name:x |
Corresponde a x como uma substring de fully_qualified_name . |
fully_qualified_name=x |
Corresponde a x como fully_qualified_name . |
Pesquisa de aspecto
Para pesquisar entradas com base nos aspectos anexados, use a consulta a seguir .
Qualificador | Descrição |
---|---|
aspect:x |
Corresponde a x como uma substring do caminho completo para o aspecto.
tipo de um aspecto anexado à entrada, no formato
projectid.location.ASPECT_TYPE_ID |
aspect=x |
Corresponde a x como o caminho completo para o tipo
de aspecto de um aspecto anexado à entrada, no formato
projectid.location.ASPECT_TYPE_ID |
aspect:xOPERATORvalue |
Pesquisa valores de campo de aspecto. Corresponde a A lista de operadores compatíveis depende do tipo de campo no da seguinte forma:
Somente os campos de nível superior do aspecto podem ser pesquisados. Por exemplo, todas as consultas a seguir correspondem a entradas em que o valor
do campo
|
Operadores lógicos
Uma consulta pode consistir em vários predicados com operadores lógicos. Se você não
especificar um operador, o AND
lógico ficará implícito. Por exemplo, foo bar
retorna
entidades que correspondem ao predicado foo
e ao predicado bar
.
AND
lógico e OR
lógico são aceitos. Por exemplo, foo OR bar
.
É possível negar um predicado com o prefixo -
(hífen) ou NOT
. Por exemplo,
-name:foo
retorna entidades com nomes que não correspondem ao predicado foo
.
Os operadores lógicos não diferenciam maiúsculas de minúsculas. Por exemplo, tanto or
quanto OR
são
aceitáveis.
Sintaxe abreviada
Uma sintaxe de pesquisa abreviada também está disponível, usando |
(barra vertical) para
Operadores OR
e ,
(vírgula) para operadores AND
.
Por exemplo, para procurar entradas dentro de um dos vários projetos usando o operador OR
, use a seguinte sintaxe abreviada:
projectid:(id1|id2|id3|id4)
A mesma pesquisa sem usar a sintaxe abreviada fica assim:
projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4
Para pesquisar entradas com nomes de coluna correspondentes, use o código abaixo:
- E:
column:(name1, name2, name3)
- OU:
column:(name1|name2|name3)
Essa sintaxe abreviada funciona para os
predicados qualificados, exceto label
.
A seguir
- Saiba como pesquisar recursos de dados. no catálogo do Dataplex
- Saiba mais sobre o Catálogo do Dataplex.
- Saiba como enriquecer entradas com metadados usando aspectos.
- Saiba como gerenciar entradas e importar fontes personalizadas.