Introdução às consultas
Muitas situações ocorrem nas quais o acesso a dados iterativos está incorreto. O Business Central tem acesso ao avançado mecanismo de gerenciamento de banco de dados relacional do Microsoft SQL Server para selecionar conjuntos complexos e de várias tabelas, de forma rápida e eficiente.
O objeto Consulta do Business Central permite que você defina modelos de dados relacionais que são convertidos em instruções SELECT eficientes. O SQL Server pode executar essas instruções como operações de recuperação de dados únicas. Essa abordagem ajuda a garantir o desempenho ideal e a pressão mínima sobre os recursos do sistema.
As consultas especificam conjuntos de dados do banco de dados do Business Central para recuperações de forma rápida e eficiente. Você pode usar consultas para recuperar dados de uma ou mais tabelas como um conjunto de resultados único e simples. Você pode especificar como associar várias tabelas no conjunto de resultados e como encomendar, agrupar, agregar e filtrar os dados resultantes.
As consultas recuperam dados com eficiência porque são sempre convertidas em uma única instrução SELECT e são executadas no banco de dados subjacente do SQL Server. Os dados são selecionados, unidos, agrupados, ordenados, agregados e filtrados no nível do SQL Server, o que garante um efeito mínimo sobre o desempenho.
As consultas permitem recuperar registros de uma ou mais tabelas ou fontes de dados e, em seguida, combinam os dados em linhas e colunas em um único conjunto de dados. As consultas também podem realizar cálculos nos dados, como encontrar a soma ou a média de todos os valores em uma coluna do conjunto de dados.
Você pode executar as seguintes tarefas com as consultas:
Use-as como fontes de gráficos no Business Central.
Salve-as como arquivos XML ou CSV (usando fluxos).
Acesse-as a partir do código de AL.
Publique-as como serviços Web OData para consumo posterior de outros clientes, como o Power BI ou outros aplicativos no Microsoft Power Platform.
Uma consulta descreve um conjunto de dados do Business Central. As consultas recuperam registros de uma ou mais tabelas e combinam os registros em linhas e colunas em um único conjunto de dado. Você pode criar consultas no ambiente de desenvolvimento.
As consultas têm os seguintes recursos:
Selecionar subconjuntos de campos de várias tabelas.
Associar tabelas a diferentes critérios de vinculação.
Filtrar tabelas especificando critérios de filtragem.
Agrupar e agregar dados.
Ordenar dados.
Limitar o número de linhas a ser recuperado.
Aplicar métodos de data.
Há dois tipos de objetos de consulta: normal e API.
Uma consulta normal recupera registros de tabelas de dados corporativos no banco de dados do Dynamics 365 Business Central e pode ser usada para exibir dados na interface do usuário. Esse tipo de consulta é criado por um objeto de consulta. Para obter mais informações, consulte Query Object.
Uma consulta de API é usada para gerar pontos de extremidade de serviço Web. Esse tipo de página não pode ser exibido na interface do usuário. Uma consulta do tipo API pode ser usada para unir dados de fontes de dados diferentes. Os dados só podem ser exibidos. Para obter informações sobre como criar uma consulta do tipo API, consulte API Query Type.
Cenários de uso de consulta
Os exemplos a seguir mostram como você pode usar consultas em seu aplicativo Business Central.
Permitindo que os usuários analisem dados de uma consulta usando o modo de análise de dados. Para obter mais informações, consulte Analisar página de lista e dados de consulta.
Expondo dados como um serviço Web OData. Você pode registrar e publicar uma consulta como um serviço Web da mesma forma que pode registrar e publicar páginas ou codeunits como serviços Web. Use a página Serviços Web para registrar e publicar páginas, codeunits ou consultas. Depois de expor uma consulta como um serviço Web, você poderá importá-la para outros aplicativos.
Usando a consulta como fonte de dados para uma página. Para isso, é necessário copiar o conjunto de dados resultante da consulta em uma tabela temporária e defini-lo como a tabela de origem da página.
Usando a consulta como fonte de dados para um relatório. Para isso, crie uma variável global que aponte para a consulta. Em seguida, use a variável no conjunto de dados do relatório. Para obter mais informações, consulte Defining a Report Dataset.
Executando cálculos em dados, como calcular somas e médias. Para obter mais informações, consulte Aggregating data in query objects.
Substituindo loops aninhados que usam variáveis de registro para recuperar ou detectar registros duplicados. Para obter mais informações, consulte Using Queries Instead of Record Variables.
Criando gráficos baseados em uma consulta em vez de uma tabela.
Salvando os dados de uma consulta como um arquivo .xml ou .csv. Por exemplo, você pode usar o método Query.SaveAsXml para criar um arquivo .xml que contém o conjunto de dados resultante de uma consulta. Você pode usar o arquivo .xml para integrar com aplicativos externos.