Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Comparar tipos de consulta flexível e fixa

Comparar tipos de consulta flexível e fixa

Atualizado: fevereiro de 2014

 

Logotipo do DataMarket

O Marketplace expõe dados usando feeds de OData. O Open Data Protocol (OData) é um protocolo da Web para consultar e atualizar dados que fornece uma maneira de desbloquear os dados e liberá-los de silos existentes em aplicativos atualmente. O OData faz isso aplicando e criando em tecnologias Web, como HTTP, JSON e protocolo de publicação Atom (AtomPub) para fornecer acesso a informações de uma variedade de aplicativos, serviços e armazenamentos.

O OData é consistente com a maneira como a Web funciona: usa URIs para identificação de recursos e uma interface uniforme, baseada em HTTP, para interagir com esses recursos. O OData fornece a capacidade de um serviço para permitir que os clientes criem dinamicamente consultas em feeds adicionando filtros, classificação e assim por diante, ou para um serviço fornecer métodos de consulta fixa (semelhante a outros pontos de extremidade de serviço Web) onde o cliente deve fornecer um conjunto específico ou um subconjunto de parâmetros e é retornado um resultado específico definido conforme determinado pelo proprietário do conteúdo. O Marketplace publica serviços que tornam o uso de ambos os tipos de consultas. O tipo de consulta disponível para um conjunto de dados é especificado na página Detalhes do conjunto de dados, conforme mostrado na imagem abaixo.

Um conjunto de dados de consulta flexível permite que você adicione filtros de nome/valor do parâmetro opcional ao consultar o conjunto de dados (columnName=dataValue), bem como uma matriz de opções de consulta do OData compatíveis com o Marketplace. Para obter mais informações sobre quais opções de consulta o Marketplace suporta, consulte Opções de consulta do OData com suporte.

Ao desenvolver um aplicativo que usa um conjunto de dados de consulta flexível, use Adicionar Referência de Serviço no Visual Studio para gerar classes .NET com rigidez de tipos que podem ser usadas para chamar o serviço OData de dentro de seu aplicativo. Consulte Step 2: Add the Service Reference for your Data Service para mais informações.

Um conjunto de dados de consulta fixa permite chamar métodos de consulta predefinida que o editor de conteúdo disponibiliza. Um método de consulta pode ter um conjunto de parâmetros necessários e/ou opcionais que permitem adicionar filtragem restrita à sua consulta. Encontre uma lista dos parâmetros necessários e/ou opcionais para qualquer conjunto de dados de consulta fixa incluído na página Detalhes do conjunto de dados.

Adicionar Referência de Serviço no Visual Studio no momento não é compatível com a geração de código para serviços de dados que é compatível com a consulta fixa. Qualquer conjunto de dados que é compatível com a consulta fixa fornece uma classe de proxy pré-criada para o conjunto de dados. O arquivo de classe de proxy está disponível na página Detalhes do conjunto de dados após a compra da assinatura. As classes de proxy usam a biblioteca de cliente do WCF Data Service para criar uma classe NET com rigidez de tipos que possa chamar o serviço OData. Consulte Criar um aplicativo de consulta fixa para mais informações.

Para determinar qual tipo de consulta oferece suporte a um conjunto de dados, consulte a seção Determinar o tipo de consulta abaixo.

Antes de prosseguir, verifique se você tem:

  • Uma conta válida do Windows Live ID. Se não tiver uma Live ID, vá para a página inicial do Windows Live e inscreva-se.

  • Uma conta válida do Marketplace. Se não tiver uma Marketplace, vá para o tópico Criar sua conta do Marketplace e siga as instruções.

  • Uma assinatura para o conjunto de dados dos Dados de Crimes nos Estados Unidos entre 2006 e 2008. Se ainda não se inscreveu nesse conjunto de dados, acesse Assinar uma oferta de dados e siga as instruções.

 

Seção Descrição

Exemplos de URI

Exemplos de consulta flexível e URIs de consulta fixa.

Determinar o tipo de consulta

Etapas para determinar se um conjunto de dados é compatível com consultas flexíveis ou fixas.

 

URI Descrição de URI

https://api.datamarket.azure.com/data.ashx/contoso.com/salesreport/GetSalesReport?region=northamerica

Consulta flexível para acessar os dados do relatório de vendas da Contoso, Ltd. para a América do Norte.

https://api.datamarket.azure.com/data.ashx/contoso.com/salesreport/GetSalesReport

Consulta flexível para acessar os dados do relatório de vendas da Contoso, Ltd.
Como nenhum parâmetro foi especificado, o conjunto de resultados é filtrado e a consulta retorna todos os relatórios de vendas no sistema.

https://api.datamarket.azure.com/Data.ashx/adatum.com/CensusInfo/GetCensusData

Consulta fixa sem parâmetros obrigatórios para acessar os dados de censo mais recentes do censo do serviço A. Datum, Inc.

A chamada para GetCensusData é o método de acesso de dados na classe de serviço C# baixada fornecida pelo Marketplace.

https://api.datamarket.azure.com/Data.ashx/thephone-company.com/accountbalance/GetAccountBalance?phonenumber=5551234567

Consulta fixa com um parâmetro obrigatório para acessar dados de saldo de conta específicos a partir do serviço Marketplace da The Phone Company.
Se o par nome/valor de parâmetro obrigatório não for fornecido, a consulta falha.

A chamada para GetAccountBalance é o método de acesso de dados na classe de serviço C# baixada fornecida pelo Marketplace.

ImportantImportante
Uma consulta flexível sem nenhum parâmetro retorna um conjunto de resultados não filtrados.
Uma consulta fixa com um número incorreto de parâmetros (muitos ou poucos) falha.

Alguns conjuntos de dados permitem apenas consultas fixas, consultas sem parâmetros ou com pares de valor/parâmetro obrigatório. Outros conjuntos de dados permitem consultas flexíveis, consultas que incluem pares de valor/parâmetro opcional para filtrar o conjunto de resultados. Descubra que tipo de consulta seu conjunto de dados requer.

  1. Clique na guia Meus Dados.

  2. Clique na palavra Usar à direita do nome do conjunto de dados que você deseja usar em seu aplicativo.

  3. Role para baixo na página para as guias abaixo da descrição do conjunto de dados.

  4. Clique na guia Detalhes.

  5. Localize a linha de texto abaixo da URL raiz do serviço que informa o tipo de consulta. Este exemplo é para uma consulta flexível.

    Tipo de consulta


    Figura 1 – Tipo de consulta

Mostrar:
© 2015 Microsoft