DataWorks:UpdateMetaEntity

Você deve adquirir o DataWorks Professional Edition ou uma edição superior para usar esta operação.

Entidades personalizadas

Para entidades personalizadas, defina EntityType como custom_entity-<name>. Você pode atualizar os seguintes itens:

Regras de atributos

Exemplo:

{
  "Comment": "Entidade personalizada atualizada",
  "Attributes": {
    "level": "L2",
    "profile": "{\"owner\":\"data_team\"}"
  },
  "CustomAttributes": {
    "biz_owner": ["data_team"]
  }
}
```.

## Objeto de banco de dados do tipo de tabela estendida

Aplica-se a `custom_<name>-database`.

| Chave de Attributes | Suportado | Tipo/formato | Descrição |
| --- | --- | --- | --- |
| `technicalMetadata.location` | Sim | String | Atualiza o local de armazenamento do banco de dados. Isso corresponde ao campo `location` no Elasticsearch. |
| `parentMetaEntityId` | Não | \- | A relação pai-filho não pode ser atualizada. Fornecer esta chave retorna um erro. |
| Outras chaves | Não | \- | Para uma entidade compartilhada, atualizar chaves que não estão na lista de permissões retorna um erro. |.

## Objeto de tabela do tipo de tabela estendida

Aplica-se a `custom_<name>-table`.

| Chave de Attributes | Suportado | Tipo/formato | Descrição |
| --- | --- | --- | --- |
| `tableType` | Sim | String | Atualiza o tipo de tabela. |
| `partitionKeys` | Sim | String de matriz JSON ou String | Se você fornecer uma matriz, o sistema une os itens com vírgulas para criar a string final. Por exemplo, `["dt","hh"]` se torna `dt,hh`. |
| `technicalMetadata.owner` | Sim | String | Atualiza o proprietário. |
| `technicalMetadata.location` | Sim | String | Atualiza o local de armazenamento. |
| `technicalMetadata.compressed` | Sim | Booleano | Suporta `true` e `false`. |
| `technicalMetadata.inputFormat` | Sim | String | Atualiza o InputFormat. |
| `technicalMetadata.outputFormat` | Sim | String | Atualiza o OutputFormat. |
| `technicalMetadata.serializationLibrary` | Sim | String | Atualiza a classe SerDe. |
| `technicalMetadata.parameters` | Sim | String de objeto JSON ou String | Se você fornecer um objeto JSON, o sistema o serializa em uma string e o grava no atributo `parameters`. |
| `parentMetaEntityId` | Não | \- | O banco de dados pai não pode ser atualizado. Fornecer esta chave retorna um erro. |
| `columns` | Não | \- | Você não pode modificar a lista de colunas usando a operação `UpdateMetaEntity`. Em vez disso, atualize cada entidade de coluna individualmente. |
| Outras chaves | Não | \- | Para uma entidade compartilhada, atualizar chaves que não estão na lista de permissões retorna um erro. |

Exemplo:

```json
{
  "Comment": "Descrição da tabela atualizada",
  "Attributes": {
    "tableType": "VIEW",
    "partitionKeys": "[\"dt\"]",
    "technicalMetadata.location": "oss://bucket/ods/order_fact",
    "technicalMetadata.compressed": "true",
    "technicalMetadata.parameters": "{\"retention\":\"30\"}"
  },
  "CustomAttributes": {
    "biz_owner": ["data_team"]
  }
}
```.

## Objeto de coluna do tipo de tabela estendida

Aplica-se a `custom_<name>-column`.

| Chave de Attributes | Suportado | Tipo/formato | Descrição |
| --- | --- | --- | --- |
| `type` | Sim | String | Atualiza o tipo de coluna. |
| `position` | Sim | Inteiro | Atualiza a posição da coluna. |
| `partitionKey` | Sim | Booleano | Define se a coluna é uma chave de partição. Isso corresponde ao campo `isPartitionKey` no Elasticsearch. |
| `primaryKey` | Sim | Booleano | Define se a coluna é uma chave primária. Isso corresponde ao campo `isPrimaryKey` no Elasticsearch. |
| `foreignKey` | Sim | Booleano | Define se a coluna é uma chave estrangeira. Isso corresponde ao campo `isForeignKey` no Elasticsearch. |
| `parentMetaEntityId` | Não | \- | A tabela pai não pode ser atualizada. Fornecer esta chave retorna um erro. |
| Outras chaves | Não | \- | Para uma entidade compartilhada, atualizar chaves que não estão na lista de permissões retorna um erro. |

A solicitação falhará se a tabela pai não existir, não pertencer ao locatário atual ou não tiver colunas embutidas.

Exemplo:

```json
{
  "Comment": "ID do pedido",
  "Attributes": {
    "type": "BIGINT",
    "position": "1",
    "primaryKey": "true"
  },
  "CustomAttributes": {
    "security_level": ["P1"]
  }
}
```.

## Operações não suportadas

| Item | Conclusão |
| --- | --- |
| Modificar nome da entidade | Não suportado. O nome é derivado do `Id`. |
| Modificar EntityType | Não suportado. O tipo é derivado do `Id`. |
| Modificar entidade pai | Não suportado. Fornecer `attributes.parentMetaEntityId` retorna um erro. |
| Modificar lista de colunas | Não suportado. Fornecer `attributes.columns` retorna um erro. |
| Criar novas colunas | Não suportado. Para adicionar colunas a uma tabela estendida, especifique-as no parâmetro `Attributes.columns` ao criar a tabela usando a operação `BatchCreateMetaEntities`. |.