Quickstart: Cognitive Search implementeren met behulp van een ARM-sjabloon

In dit artikel wordt stapsgewijs uitgelegd hoe u met behulp van een Azure Resource Manager-sjabloon (ARM-sjabloon) een Azure Cognitive Search-resource implementeert in de Azure-portal.

Een Resource Manager-sjabloon is een JavaScript Object Notation-bestand (JSON) dat de infrastructuur en configuratie van uw project definieert. Voor de sjabloon is declaratieve syntaxis vereist. In declaratieve syntaxis beschrijft u de beoogde implementatie zonder dat u de reeks programmeeropdrachten voor het maken van de implementatie hoeft te schrijven.

Als uw omgeving voldoet aan de vereisten en u benkend bent met het gebruik van ARM-sjablonen, selecteert u de knop Implementeren naar Azure. De sjabloon wordt in Azure Portal geopend.

Implementeren in Azure

Vereisten

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.

De sjabloon controleren

De sjabloon die in deze quickstart wordt gebruikt, komt uit Azure-quickstartsjablonen.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "metadata": {
        "description": "Service name must only contain lowercase letters, digits or dashes, cannot use dash as the first two or last one characters, cannot contain consecutive dashes, and is limited between 2 and 60 characters in length."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "standard",
      "allowedValues": [
        "free",
        "basic",
        "standard",
        "standard2",
        "standard3",
        "storage_optimized_l1",
        "storage_optimized_l2"
      ],
      "metadata": {
        "description": "The pricing tier of the search service you want to create (for example, basic or standard)."
      }
    },
    "replicaCount": {
      "type": "int",
      "defaultValue": 1,
      "minValue": 1,
      "maxValue": 12,
      "metadata": {
        "description": "Replicas distribute search workloads across the service. You need at least two replicas to support high availability of query workloads (not applicable to the free tier)."
      }
    },
    "partitionCount": {
      "type": "int",
      "defaultValue": 1,
      "allowedValues": [
        1,
        2,
        3,
        4,
        6,
        12
      ],
      "metadata": {
        "description": "Partitions allow for scaling of document count as well as faster indexing by sharding your index over multiple search units."
      }
    },
    "hostingMode": {
      "type": "string",
      "defaultValue": "default",
      "allowedValues": [
        "default",
        "highDensity"
      ],
      "metadata": {
        "description": "Applicable only for SKUs set to standard3. You can set this property to enable a single, high density partition that allows up to 1000 indexes, which is much higher than the maximum indexes allowed for any other SKU."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Search/searchServices",
      "apiVersion": "2020-03-13",
      "name": "[parameters('name')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[toLower(parameters('sku'))]"
      },
      "properties": {
        "replicaCount": "[parameters('replicaCount')]",
        "partitionCount": "[parameters('partitionCount')]",
        "hostingMode": "[parameters('hostingMode')]"
      }
    }
  ]
}

De Azure-resource die in deze sjabloon is gedefinieerd:

De sjabloon implementeren

Selecteer de volgende afbeelding om u aan te melden bij Azure en een sjabloon te openen. Met de sjabloon maakt u een Azure Cognitive Search-resource.

Implementeren in Azure

In de portal wordt een formulier weergegeven waarmee u eenvoudig parameterwaarden kunt opgeven. Sommige parameters worden vooraf ingevuld met de standaardwaarden uit de sjabloon. U moet uw abonnement, de resourcegroep, locatie en servicenaam opgeven. Als u Cognitive Services wilt gebruiken in een pijplijn voor AI-verrijking, bijvoorbeeld om binaire afbeeldingsbestanden voor tekst te analyseren, kiest u een locatie die zowel Cognitive Search als Cognitive Services biedt. Beide services moeten zich in dezelfde regio bevinden voor AI-verrijkingsworkloads. Wanneer u het formulier hebt ingevuld, moet u akkoord gaan met de voorwaarden en vervolgens de knop Kopen selecteren om uw implementatie te voltooien.

Weergave van sjabloon in Azure Portal

Geïmplementeerde resources bekijken

Wanneer de implementatie is voltooid, hebt u toegang tot uw nieuwe resourcegroep en nieuwe zoekservice in de portal.

Resources opschonen

Andere Cognitive Search-snelstarts en zelfstudies zijn gebaseerd op deze quickstart. Als u van plan bent om volgende quickstarts en zelfstudies te gaan gebruiken, wilt u deze resource misschien bewaren. Als u de resourcegroep niet meer nodig hebt, kunt u deze verwijderen. Hierdoor worden ook de Cognitive Search-service en de gerelateerde resources verwijderd.

Volgende stappen

In deze quickstart hebt u een Cognitive Search-service gemaakt met behulp van een ARM-sjabloon en de implementatie gevalideerd. Als u meer wilt weten over Cognitive Search en Azure Resource Manager vindt u meer informatie in de onderstaande artikelen.