Gerenciar views de métricas
Views de métricas são registradas no Unity Catalog e podem ser gerenciadas usando o Catalog Explorer. Usuários com pelo menos permissão SELECT podem ver detalhes da view de métricas, e os proprietários podem controlar o acesso, habilitar a edição colaborativa e gerenciar o ciclo de vida das views de métricas por meio da interface do usuário ou de comandos SQL.
Visualizar view de métricas no Explorador de Catálogos
O Catalog Explorer fornece uma interface para visualizar e gerenciar views de métricas.
Para acessar uma view de métricas no Catalog Explorer:
- Clique
em **Catálogo** na barra lateral.
- Navegue pelos dados disponíveis ou use a barra de pesquisa para procurar a view de métricas pelo nome.
- Clique no nome da view de métricas.
O Explorador de Catálogos exibe informação em várias tab. Use cada tab para view ou editar detalhes para a view de métricas.
Definir permissões
Visualizações de métricas usam o mesmo modelo de permissões hierárquico que outros objetos protegíveis do Unity Catalog. Nenhuma nova permissão é necessária se sua view de métricas estiver armazenada em um esquema a que os consumidores pretendidos tenham acesso de leitura. É possível atribuir permissões na visualização de métricas na tab Permissões ou usando SQL.
Conceder privilégios usando SQL
Uma view de métricas é um objeto protegível do Unity Catalog e segue o mesmo modelo de permissão que outras views. Privilégios são hierárquicos, assim privilégios em um metastore, catálogo ou esquema são transferidos em cascata para os objetos que contêm. O exemplo a seguir concede privilégios mínimos para usuários no grupo data_consumers query uma view de métricas:
GRANT SELECT ON orders_metric_view to `data-consumers`;
Para saber mais sobre privilégios no Unity Catalog, consulte Gerenciar privilégios no Unity Catalog. Para saber mais sobre como criar e gerenciar grupos, consulte Grupos.
Conceder permissões usando a IU
Você também pode conceder privilégios usando o Catalog Explorer:
- Encontre a view de métricas no Catalog Explorer.
- Clique em **Permissões**.
- Use a IU para conceder e revogar permissões para outros usuários e grupos do Databricks.
Para obter mais detalhes, consulte Conceder permissões em um objeto.
Editar uma view de métricas
É preciso ser o proprietário de uma view de métricas para editar sua definição. Para habilitar a edição colaborativa, transfira a propriedade para um grupo. Consulte Habilitar edição colaborativa.
Para editar uma view de métricas no Catalog Explorer:
- Encontre a view de métricas no Catalog Explorer.
- Clique em Editar para abrir o editor.
- Use a tab **UI** para alterar campos e medidas interativamente ou clique no
<>botão para editar a definição YAML diretamente. - Clique em Salvar .
Qualquer usuário com pelo menos SELECT privilégios pode fazer query na view de métricas. Para saber mais sobre como gerenciar permissões, consulte Definir permissões.
Editar com SQL
Para editar uma view de métricas com SQL, use ALTER VIEW com uma definição YAML atualizada. ALTER VIEW substitui a definição completa, então inclua o YAML completo, não apenas as partes que você alterar:
ALTER VIEW catalog.schema.orders_metric_view
AS $$
<complete YAML definition>
$$
Permitir edição colaborativa
Apenas o proprietário de uma view de métricas pode editar a sua definição. Para permitir que várias pessoas colaborem na mesma view de métricas, transfira a propriedade para um grupo. Todos os membros desse grupo podem então editar a definição. A view de métricas pode acessar apenas dados que o grupo tem permissão para selecionar.
Para habilitar a edição colaborativa:
- Crie ou identifique um grupo que deve ter acesso de edição à view de métricas. Consulte Grupos.
- Conceda ao grupo
SELECTacesso a todas as tabelas das quais a view de métricas depende. - Transferir a propriedade da view de métricas para o grupo. Consulte Gerenciar propriedade de objetos.
- Adicione ou remova usuários do grupo para controlar quem pode editar a view de métricas.
A transferência de propriedade para um grupo não é suportada para view de métricas materializadas. A edição colaborativa está disponível apenas para views de métricas não materializadas.
Remover uma view de métricas
Use a sintaxe DROP VIEW para excluir uma view de métrica:
DROP VIEW orders_metric_view;
A exclusão de uma view de métricas é permanente e não pode ser desfeita. Verifique se nenhum consumidor downstream (dashboards, notebooks, queries) depende da view de métricas antes de excluí-la. Use a tab Linhagem no Catalog Explorer para identificar dependências.
Limitações
As views de métricas não aceitam OpenSharing ou perfil de dados.