Partilhar via


Trabalhar com tabelas Dataverse usando código

Fornecer armazenamento para dados é a função mais importante do Dataverse. O Dataverse inclui um conjunto básico de tabelas que fornecem estrutura para dados usados por aplicativos de negócios.

Você pode visualizar o conjunto de tabelas base na referência de tabela/entidade do Dataverse.

Modificar tabelas

Você pode modificar o design da tabela usando vários métodos diferentes.

Utilizar estruturadores

Há várias formas de editar o design de tabelas usando estruturadores.

Projetista Description
make.powerapps.com A abordagem mais fácil e comum para modificar o esquema é usar o https://make.powerapps.com/ para editar tabelas Dataverse em um ambiente. As alterações aplicadas aqui são executadas no contexto de uma solução padrão do Common Data Service não gerenciada.
Explorador de soluções para a sua solução Se você distribuir uma solução, deverá criar novas tabelas, atributos ou relacionamentos no contexto da solução não gerenciada que usará para desenvolver sua solução.
Mais informações: Fabricante de soluções
A partir do editor de formulários Ao editar um formulário de aplicativo controlado por modelo para uma entidade, você pode clicar no botão Novo Campo no Gerenciador de Campos. Se criar um campo de procura, irá criar uma nova relação para o suportar.

Importar uma solução

Uma solução pode conter tabela e outros componentes personalizados. Importar uma solução gerenciada ou não gerenciada para seu ambiente Dataverse incluirá essas tabelas ou estenderá as tabelas existentes com a nova tabela que elas contêm.

A partir de uma origem de dados utilizando o Power Query

Pode criar novas tabelas e preenchê-las com dados utilizando o Power Query. Para obter mais informações: Adicionar dados a uma tabela no Dataverse usando o Power Query

Usar serviços Web para trabalhar com definições de tabela

Os serviços Web expostos no Dataverse incluem recursos para criar, ler, gravar e excluir tabelas. Esses serviços são usados com mais freqüência para ler porque esses dados podem informar seu código em tempo de execução sobre como o ambiente foi personalizado. Para obter mais informações: Trabalhar com definições de tabela usando código

Definições de tabela

O modelo de dados é armazenado no Dataverse.

A definição da tabela inclui as seguintes informações:

Data Description
_Propriedades Cada entidade tem cerca de 100 propriedades que descrevem como ela é identificada e o que pode ser feito com ela. Para obter mais informações: Definição de entidade
Attributes A propriedade entity Attributes é uma coleção de atributos ou colunas. Cada coluna tem cerca de 50 propriedades para descrever como é identificada, o tipo de dados que contém, como é formatada e o que pode ser feito com ela. Para obter mais informações: Definição de atributo
Relações Três das propriedades da entidade são coleções de relações entre tabelas. Estas coleções contêm diferentes tipos de relações: Muitos para muitos, Muitos para um e Um para muitos. Para obter mais informações: Definição de relacionamentos
Privilégios Uma das propriedades é uma coleção de entre 0 e 8 privilégios que identificam os tipos de operações de dados que podem ser executadas nessa tabela com um identificador exclusivo associado a cada uma delas. Essas operações incluem: Append, AppendTo, Assign, Create, Delete, Read, Share e Write.
Keys Por padrão, cada tabela tem um único atributo GUID (identificador global exclusivo) e a Keys propriedade é uma coleção vazia. Você pode adicionar chaves alternativas a uma tabela. Mais informações: Chaves

Gorjeta

Desenvolver uma compreensão da definição de tabela no sistema pode ajudá-lo a entender como o Dataverse funciona. Muitas das propriedades também controlam o que as tabelas em aplicativos controlados por modelo podem fazer. Os designers disponíveis para editar metadados não podem mostrar todos os detalhes encontrados nos metadados. Você pode instalar um aplicativo controlado por modelo chamado Navegador de Metadados que permitirá visualizar todas as tabelas ocultas e propriedades de metadados encontradas no sistema. Para obter mais informações: Navegar pelas definições de tabelas e colunas no seu ambiente

Mesas privadas

O Dataverse contém algumas tabelas que não se destinam ao uso de desenvolvedores de terceiros. Essas tabelas são adicionadas pela Microsoft para habilitar a funcionalidade de recurso. As tabelas privadas são indicadas pela propriedade EntityMetadata.IsPrivate. Essas tabelas não estão incluídas no documento de $metadata CSDL da API Web. No entanto, você os encontrará ao consultar metadados de entidade.

Atenção

Você não deve usar tabelas privadas nas suas soluções. Ao marcar uma tabela como privada, a Microsoft está a indicar explicitamente que não suportamos outras aplicações para utilizar a tabela. A Microsoft pode remover a tabela ou introduzir alterações significativas a qualquer momento. Não há suporte para o uso dessas tabelas por qualquer pessoa que não seja a Microsoft.

Consulte também

Visão geral do desenvolvedor do Dataverse