Todos os produtos
Search
Central de documentação

DataWorks:Atributos personalizados

Última atualização: Aug 24, 2026

Os atributos personalizados no DataWorks Data Map permitem estender os metadados de negócios para workspaces, conjuntos de dados e tabelas. Com a herança de atributos, os objetos filhos recebem automaticamente os valores dos pais, o que reduz configurações repetitivas.

Visão geral

Na governança de dados corporativos em grande escala, metadados técnicos tradicionais — como esquemas de tabelas, linhagem de dados e informações de partição — muitas vezes não descrevem completamente o contexto de negócios de um ativo. Os atributos personalizados permitem estender os metadados de negócios para workspaces, conjuntos de dados e tabelas, enquanto o mecanismo de herança facilita a manutenção em massa nas hierarquias de objetos.

Importante

Atualmente, é possível configurar atributos personalizados para workspaces, conjuntos de dados e tabelas. Objetos como código e APIs ainda não suportam atributos personalizados. Caso precise dessa funcionalidade, envie um ticket para entrar em contato com o suporte técnico.

Os atributos personalizados ajudam a resolver os seguintes problemas:

  • Falta de contexto de negócios: Metadados técnicos não respondem a perguntas essenciais de negócios, como "Quem é o proprietário do negócio?" ou "Como essa métrica é definida?".

  • Configuração ineficiente: Quando milhares de tabelas ou conjuntos de dados precisam seguir os mesmos padrões de governança, como um link de aprovação unificado, configurar cada item manualmente gera alto custo e dificuldade de manutenção.

As principais capacidades dos atributos personalizados incluem:

  • Declaração de atributos personalizados: Administradores podem definir o nome, o identificador e o tipo de um atributo (como texto ou valor de enumeração) e vinculá-lo a tipos específicos de entidades.

  • Configuração de valores de atributos: Usuários podem visualizar e editar os valores dos atributos personalizados nas entidades às quais estão vinculados.

  • Herança de atributos: Objetos filhos herdam automaticamente os valores dos atributos ao longo das hierarquias de objetos, reduzindo configurações repetitivas.

Casos de uso:

  • Rotular um conjunto de dados com informações de negócios, como domínio de negócios e proprietário dos dados, para facilitar a busca e o gerenciamento no Data Map.

  • Definir um link de aprovação de dados unificado para um workspace. Todos os conjuntos de dados desse workspace herdam automaticamente esse link, eliminando a necessidade de configuração individual.

Limitações

  • O nome de um atributo personalizado deve ser exclusivo dentro de um tenant.

  • O identificador de um atributo personalizado deve ser exclusivo dentro de um tenant e não pode ser alterado após a criação.

  • O tipo de um atributo personalizado não pode ser alterado após a criação.

Permissões

A tabela a seguir descreve as permissões necessárias para operações com atributos personalizados. Uma conta Alibaba Cloud possui todas as permissões por padrão. Esta tabela se aplica apenas a usuários RAM e funções RAM.

Ações

Descrição

Criar e gerenciar atributos personalizados

Requer uma das seguintes funções ou permissões:

  • Tenant Owner

  • Tenant Administrator

  • Tenant Data Governance Administrator

  • Um usuário RAM com a permissão DataWorksFullAccess

Configurar atributos personalizados para um workspace

Requer uma das seguintes funções:

Nível de tenant: Tenant Owner, Tenant Administrator ou Tenant Data Governance Administrator

Nível de workspace: Workspace Owner ou Workspace Administrator

Configurar atributos personalizados para um conjunto de dados

Requer uma das seguintes funções:

Nível de tenant: Tenant Owner, Tenant Administrator ou Tenant Data Governance Administrator

Nível de workspace: Workspace Owner, Workspace Administrator ou Workspace Developer

Configurar atributos personalizados para uma tabela

Para tabelas MaxCompute: Você deve ser o proprietário da tabela ou um Project Administrator.

Para outras tabelas (incluindo tipos estendidos de tabela): Requer uma das seguintes funções ou permissões:

  • Tenant Owner

  • Tenant Administrator

  • Tenant Data Governance Administrator

  • Um usuário RAM com a permissão DataWorksFullAccess

Visualizar atributos personalizados, detalhes de workspace, detalhes de conjunto de dados e detalhes de tabela

Nenhuma.

Criar um atributo personalizado

Para criar um atributo personalizado, execute as etapas a seguir.

  1. Faça login no DataWorks console. No painel de navegação à esquerda, clique em Data Map.

  2. No painel de navegação à esquerda, passe o mouse sobre o ícone de Configuration Management e selecione Custom Property Configuration.

  3. Na página de gerenciamento de atributos personalizados, clique em Add.

  4. Na caixa de diálogo Create Custom Property, configure os seguintes parâmetros:

    Categoria

    Parâmetro

    Descrição

    Attribute Configuration

    ID

    Identificador exclusivo (chave) do atributo, usado para chamadas de API. O identificador pode conter apenas letras, dígitos e sublinhados (_) e não pode ser alterado após a criação.

    Name

    Nome de exibição do atributo personalizado. Deve ser exclusivo dentro do tenant e pode ter até 128 caracteres.

    Type

    Tipo de dados do valor do atributo, imutável após a criação. Tipos suportados:

    • Enum Value: O valor é selecionado a partir de uma lista predefinida de opções.

    • Text: O valor é uma string de texto livre.

    • Link: O valor é um link que inclui um Link Title e uma URL.

    Enum Value

    Se você definir o tipo de atributo como Enum Value, deverá definir as opções disponíveis.

    Description

    Descrição do atributo personalizado.

    Effective Scope

    Applicable Entity Type

    Tipos de entidade aos quais este atributo personalizado se aplica. Os tipos suportados incluem tabelas (como MySQL, MaxCompute, EMR Hive, Hologres, Data Lake Formation, AnalyticDB for PostgreSQL e Tablestore), workspaces e conjuntos de dados.

    Inherit

    Disponível apenas para o tipo workspace.

    Quando ativado, os conjuntos de dados dentro do workspace herdam automaticamente o valor deste atributo.

    Por exemplo, se você definir o atributo "Environment Type" como "Production" para um workspace, seus conjuntos de dados associados receberão automaticamente o mesmo valor de atributo. Quando o valor do atributo pai é atualizado, o valor herdado também é atualizado.

    Allow Overwrite

    Permite que objetos filhos substituam o valor herdado. Após a substituição, o atributo torna-se um valor local e deixa de ser atualizado quando o valor pai muda.

    Enable as a Filter

    Permite usar este atributo como filtro de busca. Disponível apenas para o tipo Enum Value.

    Show on Details Page

    Define se este atributo personalizado será exibido na página de detalhes de um objeto de dados.

  5. Clique em Confirm. O atributo personalizado aparecerá na lista de gerenciamento, onde você poderá editá-lo ou excluí-lo.

Nota
  • Editar um atributo: É possível modificar o nome, a descrição, os valores de enumeração, os objetos vinculados e as regras de herança de um atributo. O identificador e o tipo do atributo são imutáveis.

  • Excluir um atributo: Excluir um atributo personalizado vinculado a um objeto de dados também remove o valor correspondente do objeto. Essa ação não pode ser revertida.

Configurar e visualizar valores de atributos personalizados

Após criar atributos personalizados, configure os valores para workspaces, conjuntos de dados e tabelas.

Configurar atributos personalizados para um workspace

  1. Na página Data Map, clique no ícone image no painel de navegação à esquerda para acessar a página Data Catalog.

  2. Expanda Dataset. A lista de workspaces aparecerá à direita.

  3. Localize o workspace desejado e edite seus valores de atributos personalizados.

  4. Após concluir a configuração, visualize os valores dos atributos personalizados na página workspace details.

Configurar atributos personalizados para um conjunto de dados

  1. Na página Data Map, clique no ícone image no painel de navegação à esquerda para acessar a página Data Catalog.

  2. Siga estas etapas para configurar atributos personalizados em um conjunto de dados:

    1. Para um novo conjunto de dados:

      Configure os valores dos atributos personalizados durante o processo de criação do conjunto de dados.

    2. Para um conjunto de dados existente:

      1. Na página Data Catalog, expanda Dataset, selecione o workspace desejado e clique no conjunto de dados alvo dentro desse workspace.

      2. Na página de detalhes do conjunto de dados, edite seus valores de atributos personalizados.

  3. Na página de detalhes do conjunto de dados, visualize os valores configurados dos atributos personalizados.

Configurar atributos personalizados para uma tabela

  1. Na página Data Map, clique no ícone image para acessar a página Data Catalog.

  2. Clique no tipo de tabela que deseja configurar, como MaxCompute. Na página de detalhes da tabela, visualize e edite os valores dos atributos personalizados.

Filtrar por atributo personalizado

Para atributos personalizados do tipo Enum Value com a opção Enable as a Filter ativada, utilize o atributo para filtrar rapidamente workspaces ou conjuntos de dados durante a busca.

Filtrar workspaces

Existem duas maneiras de filtrar workspaces por atributo personalizado:

Método 1: No painel de navegação à esquerda, clique no ícone de busca image para acessar a página Advanced Search. Selecione Workspace como tipo e defina as condições de filtro para os atributos personalizados. Para mais informações, consulte Multi-dimensional filtering and browsing.

Método 2: No painel de navegação à esquerda, clique no ícone image para acessar a página Data Catalog. Expanda Dataset, selecione o workspace desejado e filtre pelos valores de enumeração do atributo personalizado.

Filtrar conjuntos de dados

É possível filtrar conjuntos de dados por atributo personalizado de duas formas:

Método 1: No painel de navegação à esquerda, clique no ícone de busca image para acessar a página Advanced Search. Selecione Dataset como tipo e defina as condições de filtro para o atributo personalizado. Para mais informações, consulte Multi-dimensional filtering and browsing.

Método 2: No painel de navegação à esquerda, clique no ícone image para acessar a página Data Catalog. Expanda Dataset para ver a lista de workspaces, clique em Dataset e filtre os resultados com base nos valores de enumeração de um atributo personalizado.

Herança de atributos

Os atributos personalizados suportam herança nas hierarquias de objetos. Os objetos filhos recebem automaticamente os valores de atributos de seus pais.

  • Cadeia de herança: A herança de atributos personalizados segue esta hierarquia: Workspace > Dataset.

    Por exemplo, ao configurar um valor de atributo personalizado no nível do workspace, todos os conjuntos de dados dentro desse workspace herdam automaticamente esse valor.

  • Política de herança: Ao criar um atributo personalizado, selecione a opção Allow Overwrite.

    • Allow Overwrite: Por padrão, os objetos filhos (conjuntos de dados) herdam o valor do atributo do pai (workspace), mas você pode substituir o valor no objeto filho. Por exemplo, um workspace pode ser configurado com um link de aprovação padrão que a maioria de seus conjuntos de dados herda. Para um conjunto de dados específico contendo informações sensíveis, substitua esse link por outro que exija um processo de aprovação mais rigoroso.

    • Disallow Overwrite: Os objetos filhos devem herdar o valor do atributo do objeto pai e não podem modificá-lo.

  • Alteração de valor pai: Quando o valor de um atributo pai muda, o novo valor é propagado para todos os objetos filhos que o herdam. Objetos filhos com valores substituídos não são afetados.

  • Indicador de herança: Na página de detalhes do conjunto de dados, um ícone indicador aparece ao lado dos atributos personalizados herdados de um workspace. Passe o mouse sobre o ícone para visualizar a origem da herança e a política de substituição.

Documentação relacionada