Veja neste documento a sintaxe das consultas de pesquisa do Data Catalog. Antes de ler este documento, é importante que você entenda os conceitos do Data Catalog, como entrada de dados, tags e modelos de tag e outros tipos de metadados. Consulte O que é o Data Catalog?
Para iniciar uma consulta de pesquisa do Data Catalog na no console do Google Cloud, acesse a página Pesquisa do Data Catalog e selecione Data Catalog como o modo de pesquisa.
Pesquisa simples
Na forma mais simples, uma consulta de pesquisa no Data Catalog contém 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
- Tipo exato de 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
- O valor de uma tag pública, o nome de um modelo de tag pública ou o nome de um campo em um modelo de tag pública anexado a uma entrada de dados.
- (Prévia) Uma string de um endereço de e-mail ou nome de um administrador de dados
- (Prévia) String de uma descrição geral.
A pesquisa simples não oferece suporte a campos de modelos de tag do tipo datetime
.
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
foo
exato - 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
- O modelo de tag público
foo
, as entradas de dados marcadas com o modelo de tagfoo
, o nome de exibiçãofoo
, o nome do campo do modelo de tagfoo
e o valor do campofoo
em uma string, tipo enumerado ou rich text. - (Prévia) Recurso de dados com um administrador de dados chamado
foo
. - (Pré-lançamento) Recurso de dados com uma visão geral que contém a palavra
foo
.
Para saber mais sobre as funções e permissões para visualizar tags públicas e privadas, consulte Funções para visualizar tags públicas e privadas.
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 token dentro do valor nos resultados da pesquisa.
A tokenização divide o fluxo do texto em uma série de tokens, com cada token geralmente correspondente a uma única palavra.
Exemplo:
name:foo
seleciona entidades com nomes que contêm a substringfoo
:foo1
ebarfoo
.description:foo
seleciona entidades com o tokenfoo
na descrição:bar and foo
.location=foo
corresponde a todos os recursos de dados em um local especificado comfoo
como o nome do local.
O Data 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 nome da coluna aninhada) no esquema do recurso de dados.É possível pesquisar uma coluna aninhada pelo caminho usando o operador lógico AND. Por exemplo, column:(foo bar) corresponde a uma coluna aninhada com o caminho foo.bar . |
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 aos recursos de dados do BigQuery em que a chave é foo e a chave-valor é bar . |
label.foo=bar |
Corresponde a recursos de dados do BigQuery em que a chave é foo e o valor da chave é bar . |
label.foo |
Corresponde a recursos de dados do BigQuery que têm um rótulo com chave igual a foo como uma string. |
type=<type> |
Corresponde a ativos de dados de um tipo ou subtipo de objeto específico. Os subtipos podem ser adicionados com o formato <type>.<sub-type>. Os tipos e subtipos incluem:
|
projectid:bar |
Corresponde recursos de dados dentro de projetos do 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 do BigQuery. O caminho tem o formato <project_id>.<dataset_name> .Por exemplo, parent:foo.bar corresponde a todas as tabelas e visualizações de um conjunto de dados com o caminho project-foo.bar-dataset . |
orgid=number |
Corresponde os recursos de dados em uma organização do Cloud ao valor exato do ID de number . |
system=<system> |
Corresponde a todos os ativos de dados de um sistema especificado. Os sistemas incluem:
|
location=<location> |
Corresponde todos os recursos de dados em um local especificado com um nome exato. Por exemplo, location=us-central1 corresponde a todos os recursos hospedados em Iowa.Para ver uma lista completa de locais compatíveis, consulte Regiões do Data Catalog. |
cluster_location=<location> |
Corresponde a todos os recursos de dados do Bigtable em um local especificado com um nome exato. Por exemplo, cluster_location=us-central1 corresponde a todos os recursos hospedados em Iowa.Para acessar uma lista completa de locais compatíveis, consulte Regiões do Bigtable. |
tag:x |
Corresponde a recursos de dados em que x corresponde a qualquer subsequência em <tag_template_project_id >.<tag_template_id >.<tag_field_id > de uma tag privada ou pública.Exemplos:
|
tag:key<operator>val |
Primeiro, corresponde ao key com qualquer substring do ID do campo de tag, do ID do modelo de tag ou do ID do projeto do Google Cloud de um modelo de tag. Em seguida, corresponde val ao valor da tag de key , dependendo do tipo de campo de tag.Os conjuntos <operator> dependentes de tipo permitidos para valores de tag são:
|
createtime |
Encontra recursos de dados que foram criados em, antes ou depois de uma determinada data ou hora. Exemplos:
|
updatetime |
Encontra recursos de dados que foram atualizados em, antes ou depois de uma determinada data ou hora. Exemplos:
|
policytag:x |
Corresponde a x como uma substring do nome de exibição da tag de política. Encontra todos os recursos usando a tag da política de correspondência ou os descendentes. |
policytagid=x |
Corresponde a x como um ID de tag de política ou taxonomia. Encontra todos os recursos usando a tag da política de correspondência ou os descendentes. |
term:x |
Corresponde recursos de dados a um termo do glossário de negócios em que uma substring de nome, descrição ou administrador de dados corresponde a x . |
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 . |
Operadores lógicos
Uma consulta pode ser composta por vários
predicados com operadores lógicos. Se você não especificar um operador, a lógica
AND
está implícito. Por exemplo, foo bar
retorna entidades que correspondem a ambos
predicado foo
e predicado bar
.
Lógico "E" e lógico "OU" são suportados, por exemplo, foo OR bar
.
É possível negar um predicado com um prefixo -
ou NOT
. Por exemplo, -name:foo
retorna
todas as entidades com nomes que não correspondem ao predicado foo
.
Sintaxe abreviada
Uma sintaxe de pesquisa abreviada também está disponível, usando |
para operadores OR
e
,
para operadores AND
.
Por exemplo, para procurar entradas dentro de um dos vários projetos usando o operador OR
, você pode usar:
projectid:(pid1|pid2|pid3|pid4)
Em vez de:
projectid:pid1 OR projectid:pid2 OR projectid:pid3 OR projectid:pid4
Para pesquisar entradas com nomes de coluna correspondentes:
- E:
column:(name1, name2, name3)
- OU:
column:(name1|name2|name3)
Esta sintaxe abreviada funciona para os URLs qualificados,
predicados listados anteriormente, exceto tag
, term
,
policytag
, policytagid
e label
.