1 - Visão geral da adição de pesquisa a um site com .NET

  • Artigo

Este tutorial cria um site para pesquisar um catálogo de livros e, em seguida, implanta o site em um Aplicativo Web Estático do Azure.

O que faz a amostra?

Este site de exemplo fornece acesso a um catálogo de 10.000 livros. Um usuário pode pesquisar o catálogo inserindo texto na barra de pesquisa. Enquanto o usuário insere texto, o site usa o recurso de sugestão do índice de pesquisa para completar o texto. Quando a consulta terminar, a lista de livros será exibida com uma parte dos detalhes. Um usuário pode selecionar um livro para ver todos os detalhes, armazenados no índice de pesquisa, do livro.

Screenshot of the sample app in a browser window.

A experiência de pesquisa inclui:

  • Pesquisa – fornece funcionalidade de pesquisa para o aplicativo.
  • Sugerir – fornece sugestões à medida que o utilizador escreve na barra de pesquisa.
  • Facetas e filtros - fornece uma estrutura de navegação facetada que filtra por autor ou idioma.
  • Resultados paginados - fornece controles de paginação para rolar pelos resultados.
  • Pesquisa de Documentos – procura um documento por ID para recuperar todo o seu conteúdo para a página de detalhes.

Como está organizada a amostra?

O código de exemplo inclui o seguinte:

Aplicação Objetivo GitHub
Repositório
Localização
Cliente Aplicativo React (camada de apresentação) para exibir livros, com pesquisa. Ele chama o aplicativo Azure Function. /search-website-functions-v4/cliente
Servidor Aplicativo Azure .NET Function (camada de negócios) - chama a API de Pesquisa do Azure AI usando o SDK do .NET /search-website-functions-v4/api
Inserção em massa .NET para criar o índice e adicionar documentos a ele. /search-website-functions-v4/bulk-insert

Configurar o ambiente de desenvolvimento

Instale o seguinte para seu ambiente de desenvolvimento local.

Fork e clone a amostra de pesquisa com git

Falsificar o repositório de exemplo é fundamental para poder implantar o Static Web App. Os aplicativos Web determinam as ações de compilação e o conteúdo de implantação com base em seu próprio local de bifurcação do GitHub. A execução de código no Aplicativo Web Estático é remota, com os Aplicativos Web Estáticos do Azure lendo o código em seu exemplo bifurcado.

  1. No GitHub, bifurque o repositório de exemplo.

    Conclua o processo de bifurcação em seu navegador da Web com sua conta do GitHub. Este tutorial usa sua bifurcação como parte da implantação em um Aplicativo Web Estático do Azure.

  2. Em um terminal Bash, baixe seu aplicativo de amostra bifurcado para seu computador local.

    Substitua YOUR-GITHUB-ALIAS pelo seu alias do GitHub.

    git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples

  3. No mesmo terminal Bash, vá para o seu repositório bifurcado para este exemplo de pesquisa no site:

    cd azure-search-dotnet-samples

  4. Use o comando code . Visual Studio Code para abrir seu repositório bifurcado. As tarefas restantes são realizadas a partir do Visual Studio Code, a menos que especificado.

    code .

Criar um grupo de recursos para seus recursos do Azure

  1. No Visual Studio Code, abra a barra de atividades e selecione o ícone do Azure.

  2. Entre no Azure, se ainda não estiver conectado.

  3. Na secção Recursos, selecione Adicionar (+) e, em seguida, selecione Criar Grupo de Recursos.

    Screenshot of Visual Studio Code, in Azure explorer, showing **Create Resource Group** option.

  4. Insira um nome de grupo de recursos, como cognitive-search-demo-rg.

  5. Insira uma região:

    • Em Node.js, selecione West US 2. Esta é a região recomendada para a pré-visualização do modelo de programação (PM) do Azure Function v4.
    • Para C# e Python, recomendamos as seguintes regiões, suportadas pelos Aplicativos Web Estáticos do Azure no momento em que este artigo foi escrito: West US 2, , , , , East US 2West EuropeCentral USEast Asia

Use este grupo de recursos para todos os recursos criados durante este tutorial. Um grupo de recursos fornece uma unidade lógica para gerenciar os recursos, incluindo excluí-los quando terminar.

Próximos passos