Compartilhar via


Trabalhar com tabelas do Dataverse usando código

Fornecer armazenamento para dados é a função mais importante do Dataverse. O Dataverse inclui um conjunto base de tabelas que fornecem estrutura para dados usados por aplicativos empresariais.

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

Modificar tabelas

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

Usar designers

Existem várias maneiras de editar o design de tabelas usando ferramentas de design.

Desenhista Description
make.powerapps.com A abordagem mais fácil e comum para modificar o esquema é usar o https://make.powerapps.com/ para editar tabelas do 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 seu projeto Se você distribuir uma solução, deverá criar quaisquer novas tabelas, atributos ou relações no contexto da solução não gerenciada que você utilizará para desenvolver sua solução.
Mais informações: Fornecedor de soluções
No 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 você criar um campo de pesquisa, criará um novo relacionamento para dar suporte a ele.

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 do Dataverse incluirá essas tabelas ou estenderá tabelas existentes com a nova tabela que elas contêm.

De uma fonte de dados usando o Power Query

Você pode criar novas tabelas e preenchê-las com dados usando o Power Query. 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 frequência para ler porque esses dados podem informar seu código em runtime sobre como o ambiente foi personalizado. Mais informações: Trabalhar com definições de tabela usando código

Definições da tabela

O modelo de dados é armazenado no Dataverse.

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

Dados Description
Propriedades Cada entidade tem quase 100 propriedades que descrevem como ela é identificada e o que pode ser feito com ela. Mais informações: Definição de entidade
Attributes A propriedade da entidade Attributes é uma coleção de atributos ou colunas. Cada coluna tem cerca de 50 propriedades para descrever como ela é identificada, o tipo de dados que contém, como ela é formatada e o que pode ser feito com ela. Mais informações: Definição de atributo
Relationships Três das propriedades da entidade são coleções de relações entre tabelas. Essas coleções contêm diferentes tipos de relações: Muitos para Muitos, Muitos-para-Um e Um-para-Muitos. Mais informações: Definição de relações
Privilégios Uma das propriedades é uma coleção de privilégios entre 0 e 8 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: Acrescentar, Acrescentar,Atribuir, Criar, Excluir, Ler, Compartilhar e Gravar.
Teclas 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

Dica

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 tabelas em aplicativos controlados por modelos 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á que você exiba todas as tabelas ocultas e as propriedades de metadados encontradas no sistema. Mais informações: Navegar nas definições de tabelas e colunas em seu ambiente

Tabelas 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 recursos. Tabelas privadas são indicadas pela propriedade EntityMetadata.IsPrivate Essas tabelas não estão incluídas no documento $metadata CSDL da API Web. No entanto, você os encontrará ao consultar metadados de entidade.

Cuidado

Você não deve usar tabelas privadas em suas soluções. Marcando uma tabela como privada, a Microsoft indica explicitamente que não há suporte para outros aplicativos usarem 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