2\. Creación y carga de un índice de búsqueda con .NET

Siga estos pasos para crear el sitio web habilitado para la búsqueda:

• Creación de un recurso de búsqueda
• Creación de un nuevo índice
• Importación de datos con .NET mediante el script de ejemplo y el SDK de Azure Azure.Search.Documents.

Creación de un recurso de Azure AI Search

Cree un nuevo recurso de búsqueda desde la línea de comandos mediante la CLI de Azure o Azure PowerShell. Puede recuperar una clave de consulta que se usa para el acceso de lectura al índice y obtendrá la clave de administrador integrada que se usa para agregar objetos.

Debe tener la CLI de Azure o Azure PowerShell instalado en el dispositivo. Si no es un administrador local en el dispositivo, elija Azure PowerShell y use el parámetro Scope para ejecutar como el usuario actual.

Nota:

Esta tarea no requiere las extensiones de Visual Studio Code para la CLI de Azure y Azure PowerShell. Visual Studio Code reconoce las herramientas de línea de comandos sin las extensiones.

CLI de Azure

1. En Visual Studio Code, en Terminal, seleccione Nuevo terminal.

2. Conexión a Azure:

   az login
   

3. Antes de crear un nuevo servicio de búsqueda, enumere los servicios existentes para la suscripción:

   az resource list --resource-type Microsoft.Search/searchServices --output table
   

   Si tiene un servicio que desea usar, anote el nombre y, a continuación, vaya directamente a la sección siguiente.

4. Cree un nuevo servicio de búsqueda. Use el siguiente comando como plantilla, sustituyendo los valores válidos para el grupo de recursos, el nombre del servicio, el nivel, la región, las particiones y las réplicas. La siguiente instrucción usa el grupo de recursos "cognitive-search-demo-rg" creado en un paso anterior y especifica el nivel "gratis". Si la suscripción de Azure ya tiene un servicio de búsqueda gratuito, especifique un nivel facturable, como "básico" en su lugar.

   az search service create --name my-cog-search-demo-svc --resource-group cognitive-search-demo-rg --sku free --partition-count 1 --replica-count 1
   

5. Obtenga una clave de consulta que conceda acceso de lectura a un servicio de búsqueda. Un servicio de búsqueda se aprovisiona con dos claves de administrador y una clave de consulta. Sustituya los nombres válidos para el grupo de recursos y el servicio de búsqueda. Copie la clave de consulta en el Bloc de notas para poder pegarla en el código de cliente en un paso posterior:

   az search query-key list --resource-group cognitive-search-demo-rg --service-name my-cog-search-demo-svc
   

6. Obtenga una clave de API de administración del servicio de búsqueda. Una clave de API de administrador proporciona acceso de escritura al servicio de búsqueda. Copie una de las claves de administrador en el Bloc de notas para que pueda usarla en el paso de importación masiva que crea y carga un índice:

   az search admin-key show --resource-group cognitive-search-demo-rg --service-name my-cog-search-demo-svc
   

PowerShell

1. En Visual Studio Code, en Terminal, seleccione Nuevo terminal.

2. Conexión a Azure:

   Connect-AzAccount
   

   Si tiene varios inquilinos y suscripciones, agregue los parámetros para Connect-AzAccountTenantID y SubscriptionID al cmdlet.

3. Antes de crear un nuevo servicio de búsqueda, puede enumerar los servicios de búsqueda existentes de la suscripción para ver si hay uno que desea usar:

   Get-AzResource -ResourceType Microsoft.Search/searchServices | ft
   

   Si tiene un servicio que desea usar, anote el nombre y, a continuación, vaya directamente a la sección siguiente.

4. Cargue el módulo Az.Search (puede omitir Scope si es administrador local):

   Install-Module -Name Az.Search -Scope CurrentUser
   

5. Cree un nuevo servicio de búsqueda. Use el siguiente cmdlet como plantilla, sustituyendo los valores válidos para el grupo de recursos, el nombre del servicio, el nivel, la región, las particiones y las réplicas. La siguiente instrucción usa el grupo de recursos "cognitive-search-demo-rg" creado en un paso anterior y especifica el nivel "gratis". Si la suscripción de Azure ya tiene un servicio de búsqueda gratuito, especifique un nivel facturable, como "básico" en su lugar. Para obtener más información sobre este cmdlet, consulta Administración del servicio Azure AI Search con PowerShell.

   New-AzSearchService -ResourceGroupName "cognitive-search-demo-rg"  -Name "my-cog-search-demo-svc" -Sku "free" -Location "West US" -PartitionCount 1 -ReplicaCount 1 -HostingMode Default
   

6. Obtenga una clave de consulta y cópiela en el Bloc de notas para un paso futuro:

   Get-AzSearchQueryKey -ResourceGroupName "cognitive-search-demo-rg" -ServiceName "my-cog-search-demo-svc"
   

7. Obtenga las claves de administrador y copie una en el Bloc de notas para un paso futuro:

   Get-AzSearchAdminKeyPair -ResourceGroupName "cognitive-search-demo-rg" -ServiceName "my-cog-search-demo-svc"
   

Ahora tienes un recurso y claves de Azure AI Search que se usan para autenticar solicitudes en conexiones al punto de conexión.

Preparación del script de importación en bloque para Search

El script utiliza el SDK de Azure para Azure AI Search:

• Paquete NuGet Azure.Search.Documents
• Documentación de referencia

1. En Visual Studio Code, abra el archivo Program.cs del subdirectorio, search-website-functions-v4/bulk-insert, y reemplace las siguientes variables por sus propios valores para autenticarse con el SDK de Azure Search:

   • YOUR-SEARCH-RESOURCE-NAME
   • YOUR-SEARCH-ADMIN-KEY

   
   using Azure;
   using Azure.Search.Documents;
   using Azure.Search.Documents.Indexes;
   using Azure.Search.Documents.Indexes.Models;
   using AzureSearch.BulkInsert;
   using ServiceStack;
   
   const string BOOKS_URL = "https://raw.githubusercontent.com/Azure-Samples/azure-search-sample-data/main/good-books/books.csv";
   const string SEARCH_ENDPOINT = "https://YOUR-SEARCH-RESOURCE-NAME.search.windows.net";
   const string SEARCH_KEY = "YOUR-SEARCH-ADMIN-KEY";
   const string SEARCH_INDEX_NAME = "good-books";
   
   Uri searchEndpointUri = new(SEARCH_ENDPOINT);
   
   SearchClient client = new(
       searchEndpointUri,
       SEARCH_INDEX_NAME,
       new AzureKeyCredential(SEARCH_KEY));
   
   SearchIndexClient clientIndex = new(
       searchEndpointUri,
       new AzureKeyCredential(SEARCH_KEY));
   
   await CreateIndexAsync(clientIndex);
   await BulkInsertAsync(client);
   
   static async Task CreateIndexAsync(SearchIndexClient clientIndex)
   {
       Console.WriteLine("Creating (or updating) search index");
       SearchIndex index = new BookSearchIndex(SEARCH_INDEX_NAME);
       var result = await clientIndex.CreateOrUpdateIndexAsync(index);
   
       Console.WriteLine(result);
   }
   
   static async Task BulkInsertAsync(SearchClient client)
   {
       Console.WriteLine("Download data file");
       using HttpClient httpClient = new();
   
       var csv = await httpClient.GetStringAsync(BOOKS_URL);
   
       Console.WriteLine("Reading and parsing raw CSV data");
       var books =
           csv.ReplaceFirst("book_id", "id").FromCsv<List<BookModel>>();
   
       Console.WriteLine("Uploading bulk book data");
       _ = await client.UploadDocumentsAsync(books);
   
       Console.WriteLine("Finished bulk inserting book data");
   }
   

2. Abra un terminal integrado en Visual Studio Code para el subdirectorio del directorio del proyecto, search-website-functions-v4/bulk-insert, y ejecute el siguiente comando para instalar las dependencias.

   dotnet restore
   

Ejecución del script de importación en bloque para Search

1. Siga utilizando el terminal integrado en Visual Studio para el subdirectorio del directorio del proyecto, search-website-functions-v4/bulk-insert, a fin de ejecutar el siguiente comando de Bash para ejecutar el script Program.cs:

   dotnet run
   

2. A medida que se va ejecutando el código, la consola muestra el progreso.

3. Una vez que se ha completado la carga, la última instrucción impresa en la consola es "Finished bulk inserting book data" (Inserción masiva de datos de libro finalizada).

Revisión del nuevo índice de búsqueda

Una vez que la carga se completa, el índice de búsqueda está preparado para su uso. Examine el índice nuevo en Azure Portal.

1. En Azure Portal, busque el servicio de búsqueda que creó en el paso anterior.

2. A la izquierda, seleccione Índices y, a continuación, seleccione el índice de libros correctos.

   

3. De forma predeterminada, el índice se abre en la pestaña Explorador de búsqueda. Seleccione Buscar para devolver documentos del índice.

   

Reversión de cambios de archivos de importación masiva

Use el siguiente comando git en el terminal de Visual Studio Code integrado en el directorio bulk-insert para revertir los cambios. No son necesarios para continuar con el tutorial y no debe guardar ni insertar estos secretos en el repositorio.

git checkout .

Copia del nombre del recurso Search

Anote el nombre del recurso Search. Lo necesitará para conectar la aplicación de funciones de Azure a su recurso de Search.

Precaución

Aunque es posible que se sienta tentado a utilizar la clave de administrador de Search en Azure Functions, eso no sigue el principio de privilegios mínimos. Función de Azure usará la clave de consulta para ajustarse al privilegio mínimo.

Pasos siguientes

Implementación de la aplicación web estática