Skip to content

Commit 78cad1e

Browse files
authored
Revert "Writer sync master to release-ignite branch"
1 parent 9691aec commit 78cad1e

File tree

149 files changed

+2882
-3285
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

149 files changed

+2882
-3285
lines changed

articles/search/TOC.yml

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,20 @@
1-
- name: Azure Cognitive Search Documentation
1+
- name: Azure Search Documentation
22
href: index.yml
33
- name: Overview
4-
expanded: true
54
items:
6-
- name: What is Azure Cognitive Search?
5+
- name: What is Azure Search?
76
href: search-what-is-azure-search.md
8-
- name: What's new
9-
href: whats-new.md
107
- name: Quickstarts
8+
expanded: true
119
items:
1210
- name: Create a service
1311
href: search-create-service-portal.md
1412
- name: Portal
1513
items:
16-
- name: Create a search index
14+
- name: Create and use an index
1715
href: search-get-started-portal.md
18-
- name: Create a cognitive skillset
16+
- name: Enrich with cognitive search (AI)
1917
href: cognitive-search-quickstart-blob.md
20-
- name: Create a knowledge store
21-
href: knowledge-store-create-portal.md
2218
- name: C#
2319
href: search-get-started-dotnet.md
2420
- name: Java
@@ -83,16 +79,14 @@
8379
items:
8480
- name: Full-text search
8581
href: search-lucene-query-architecture.md
86-
- name: AI enrichment
82+
- name: Cognitive search
8783
href: cognitive-search-concept-intro.md
8884
- name: Skillsets
8985
href: cognitive-search-working-with-skillsets.md
9086
- name: Knowledge store
9187
href: knowledge-store-concept-intro.md
9288
- name: Projections
9389
href: knowledge-store-projection-overview.md
94-
- name: Incremental indexing
95-
href: cognitive-search-incremental-indexing-conceptual.md
9690
- name: How-to guides
9791
items:
9892
- name: Planning
@@ -215,8 +209,6 @@
215209
href: search-howto-schedule-indexers.md
216210
- name: Map fields
217211
href: search-indexer-field-mappings.md
218-
- name: Incremental indexing
219-
href: search-howto-incremental-index.md
220212
- name: Connect to SQL Managed Instance
221213
href: search-howto-connecting-azure-sql-mi-to-azure-search-using-indexers.md
222214
- name: Connect to SQL Server VMs
@@ -255,6 +247,8 @@
255247
href: cognitive-search-resources-documentation.md
256248
- name: Knowledge store (preview)
257249
items:
250+
- name: Create a knowledge store in Azure portal
251+
href: knowledge-store-create-portal.md
258252
- name: Create using REST and Postman
259253
href: knowledge-store-create-rest.md
260254
- name: View with Storage Explorer

articles/search/cognitive-search-attach-cognitive-services.md

Lines changed: 23 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,67 @@
11
---
2-
title: Attach a Cognitive Services resource to a skillset
3-
titleSuffix: Azure Cognitive Search
4-
description: Instructions for attaching a Cognitive Services all-in-one subscription to an AI enrichment pipeline in Azure Cognitive Search.
5-
2+
title: Attach a Cognitive Services resource with a skillset - Azure Search
3+
description: Instructions for attaching a Cognitive Services all-in-one subscription to a cognitive enrichment pipeline in Azure Search.
64
manager: nitinme
75
author: LuisCabrer
8-
ms.author: luisca
9-
ms.service: cognitive-search
6+
services: search
7+
ms.service: search
108
ms.topic: conceptual
11-
ms.date: 11/04/2019
9+
ms.date: 05/20/2019
10+
ms.author: luisca
1211
---
13-
# Attach a Cognitive Services resource to a skillset in Azure Cognitive Search
12+
# Attach a Cognitive Services resource with a skillset in Azure Search
1413

15-
AI algorithms drive the [enrichment pipelines](cognitive-search-concept-intro.md) used for content transformation in Azure Cognitive Search. These algorithms are based on Azure Cognitive Services resources, including [Computer Vision](https://azure.microsoft.com/services/cognitive-services/computer-vision/) for image analysis and optical character recognition (OCR) and [Text Analytics](https://azure.microsoft.com/services/cognitive-services/text-analytics/) for entity recognition, key phrase extraction, and other enrichments. As used by Azure Cognitive Search for document enrichment purposes, the algorithms are wrapped inside a *skill*, placed in a *skillset*, and referenced by an *indexer* during indexing.
14+
AI algorithms drive the [cognitive indexing pipelines](cognitive-search-concept-intro.md) used for document enrichment in Azure Search. These algorithms are based on Azure Cognitive Services resources, including [Computer Vision](https://azure.microsoft.com/services/cognitive-services/computer-vision/) for image analysis and optical character recognition (OCR) and [Text Analytics](https://azure.microsoft.com/services/cognitive-services/text-analytics/) for entity recognition, key phrase extraction, and other enrichments. As used by Azure Search for document enrichment purposes, the algorithms are wrapped inside a *skill*, placed in a *skillset*, and referenced by an *indexer* during indexing.
1615

17-
You can enrich a limited number of documents for free. Or, you can attach a billable Cognitive Services resource to a *skillset* for larger and more frequent workloads. In this article, you'll learn how to attach a billable Cognitive Services resource to enrich documents during Azure Cognitive Search [indexing](search-what-is-an-index.md).
16+
You can enrich a limited number of documents for free. Or, you can attach a billable Cognitive Services resource to a *skillset* for larger and more frequent workloads. In this article, you'll learn how to attach a billable Cognitive Services resource to enrich documents during Azure Search [indexing](search-what-is-an-index.md).
1817

1918
> [!NOTE]
20-
> Billable events include calls to Cognitive Services APIs and image extraction as part of the document-cracking stage in Azure Cognitive Search. There is no charge for text extraction from documents or for skills that do not call Cognitive Services.
19+
> Billable events include calls to Cognitive Services APIs and image extraction as part of the document-cracking stage in Azure Search. There is no charge for text extraction from documents or for skills that do not call Cognitive Services.
2120
>
22-
> Execution of billable skills is at the [Cognitive Services pay-as-you go price](https://azure.microsoft.com/pricing/details/cognitive-services/). For image extraction pricing, see the [Azure Cognitive Search pricing page](https://go.microsoft.com/fwlink/?linkid=2042400).
21+
> Execution of billable skills is at the [Cognitive Services pay-as-you go price](https://azure.microsoft.com/pricing/details/cognitive-services/). For image extraction pricing, see the [Azure Search pricing page](https://go.microsoft.com/fwlink/?linkid=2042400).
2322
2423
## Same-region requirement
2524

26-
We require that Azure Cognitive Search and Azure Cognitive Services exist within the same region. Otherwise, you will get this message at run time: `"Provided key is not a valid CognitiveServices type key for the region of your search service."`
25+
We require that Azure Search and Azure Cognitive Services exist within the same region. Otherwise, you will get this message at run time: `"Provided key is not a valid CognitiveServices type key for the region of your search service."`
2726

28-
There is no way to move a service across regions. If you get this error, you should create a new Cognitive Services resource in the same region as Azure Cognitive Search.
27+
There is no way to move a service across regions. If you get this error, you should create a new Cognitive Services resource in the same region as Azure Search.
2928

3029
> [!NOTE]
31-
> Some built-in skills are based on non-regional Cognitive Services (for example, the [Text Translation Skill](cognitive-search-skill-text-translation.md)). Be aware that if you add any of these skills to your skillset that your data is not guaranteed to stay in the same region as your Azure Cognitive Search or Cognitive Services resource. See the [service status page](https://aka.ms/allinoneregioninfo) for more details.
30+
> Some built-in skills are based on non-regional Cognitive Services (for example, the [Text Translation Skill](cognitive-search-skill-text-translation.md)). Be aware that if you add any of these skills to your skillset that your data is not guaranteed to stay in the same region as your Azure Search or Cognitive Services resource. See the [service status page](https://aka.ms/allinoneregioninfo) for more details.
3231
3332
## Use Free resources
3433

35-
You can use a limited, free processing option to complete the AI enrichment tutorial and quickstart exercises.
34+
You can use a limited, free processing option to complete the cognitive search tutorial and quickstart exercises.
3635

3736
Free (Limited enrichments) resources are restricted to 20 documents per day, per subscription.
3837

3938
1. Open the Import data wizard:
4039

4140
![Open the Import data wizard](media/search-get-started-portal/import-data-cmd.png "Open the Import data wizard")
4241

43-
1. Choose a data source and continue to **Add AI enrichment (Optional)**. For a step-by-step walkthrough of this wizard, see [Create an index in the Azure portal](search-get-started-portal.md).
42+
1. Choose a data source and continue to **Add cognitive search (Optional)**. For a step-by-step walkthrough of this wizard, see [Import, index, and query by using portal tools](search-get-started-portal.md).
4443

4544
1. Expand **Attach Cognitive Services** and then select **Free (Limited enrichments)**:
4645

4746
![Expanded Attach Cognitive Services section](./media/cognitive-search-attach-cognitive-services/attach1.png "Expanded Attach Cognitive Services section")
4847

49-
1. You can now continue on to the next steps, including **Add cognitive skills**.
48+
1. Continue to the next step, **Add Enrichments**. For a description of skills available in the portal, see [Step 2: Add cognitive skills](cognitive-search-quickstart-blob.md#create-the-enrichment-pipeline) in the cognitive search quickstart.
5049

5150
## Use billable resources
5251

5352
For workloads that create more than 20 enrichments per day, make sure to attach a billable Cognitive Services resource. We recommend that you always attach a billable Cognitive Services resource, even if you never intend to call Cognitive Services APIs. Attaching a resource overrides the daily limit.
5453

5554
You're charged only for skills that call the Cognitive Services APIs. You're not billed for [custom skills](cognitive-search-create-custom-skill-example.md), or skills like [text merger](cognitive-search-skill-textmerger.md), [text splitter](cognitive-search-skill-textsplit.md), and [shaper](cognitive-search-skill-shaper.md), which aren't API-based.
5655

57-
1. Open the Import data wizard, choose a data source, and continue to **Add AI enrichment (Optional)**.
56+
1. Open the Import data wizard, choose a data source, and continue to **Add cognitive search (Optional)**.
5857

5958
1. Expand **Attach Cognitive Services** and then select **Create new Cognitive Services resource**. A new tab opens so that you can create the resource:
6059

6160
![Create a Cognitive Services resource](./media/cognitive-search-attach-cognitive-services/cog-services-create.png "Create a Cognitive Services resource")
6261

63-
1. In the **Location** list, select the region where your Azure Cognitive Search service is located. Make sure to use this region for performance reasons. Using this region also voids outbound bandwidth charges across regions.
62+
1. In the **Location** list, select the region where your Azure Search service is located. Make sure to use this region for performance reasons. Using this region also voids outbound bandwidth charges across regions.
6463

65-
1. In the **Pricing tier** list, select **S0** to get the all-in-one collection of Cognitive Services features, including the Vision and Language features that back the built-in skills provided by Azure Cognitive Search.
64+
1. In the **Pricing tier** list, select **S0** to get the all-in-one collection of Cognitive Services features, including the Vision and Language features that back the predefined skills used by Azure Search.
6665

6766
For the S0 tier, you can find rates for specific workloads on the [Cognitive Services pricing page](https://azure.microsoft.com/pricing/details/cognitive-services/).
6867

@@ -76,7 +75,7 @@ You're charged only for skills that call the Cognitive Services APIs. You're not
7675

7776
![Select the Cognitive Services resource](./media/cognitive-search-attach-cognitive-services/attach2.png "Select the Cognitive Services resource")
7877

79-
1. Expand the **Add cognitive skills** section to select the specific cognitive skills that you want to run on your data. Complete the rest of the wizard.
78+
1. Expand the **Add Enrichments** section to select the specific cognitive skills that you want to run on your data. Complete the rest of the wizard. For a description of skills available in the portal, see [Step 2: Add cognitive skills](cognitive-search-quickstart-blob.md#create-the-enrichment-pipeline) in the cognitive search quickstart.
8079

8180
## Attach an existing skillset to a Cognitive Services resource
8281

@@ -94,7 +93,7 @@ If you have an existing skillset, you can attach it to a new or different Cognit
9493

9594
## Attach Cognitive Services programmatically
9695

97-
When you're defining the skillset programmatically, add a `cognitiveServices` section to the skillset. In that section, include the key of the Cognitive Services resource that you want to associate with the skillset. Remember that the resource must be in the same region as your Azure Cognitive Search resource. Also include `@odata.type`, and set it to `#Microsoft.Azure.Search.CognitiveServicesByKey`.
96+
When you're defining the skillset programmatically, add a `cognitiveServices` section to the skillset. In that section, include the key of the Cognitive Services resource that you want to associate with the skillset. Remember that the resource must be in the same region as your Azure Search resource. Also include `@odata.type`, and set it to `#Microsoft.Azure.Search.CognitiveServicesByKey`.
9897

9998
The following example shows this pattern. Notice the `cognitiveServices` section at the end of the definition.
10099

@@ -154,7 +153,7 @@ The prices shown in this article are hypothetical. They're used to illustrate th
154153
Putting it all together, you'd pay about $57.00 to ingest 1,000 PDF documents of this type with the described skillset.
155154

156155
## Next steps
157-
+ [Azure Cognitive Search pricing page](https://azure.microsoft.com/pricing/details/search/)
156+
+ [Azure Search pricing page](https://azure.microsoft.com/pricing/details/search/)
158157
+ [How to define a skillset](cognitive-search-defining-skillset.md)
159158
+ [Create Skillset (REST)](https://docs.microsoft.com/rest/api/searchservice/create-skillset)
160159
+ [How to map enriched fields](cognitive-search-output-field-mapping.md)

articles/search/cognitive-search-common-errors-warnings.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,20 @@
11
---
2-
title: Common Errors and Warnings
3-
titleSuffix: Azure Cognitive Search
4-
description: This article provides information and solutions to common errors and warnings you might encounter during AI enrichment in Azure Cognitive Search.
5-
6-
manager: nitinme
2+
title: Common Errors and Warnings - Azure Search
3+
description: This article provides information and solutions to common errors and warnings you might encounter during AI enrichment in Azure Search.
4+
services: search
5+
manager: heidist
76
author: amotley
8-
ms.author: abmotley
9-
ms.service: cognitive-search
7+
8+
ms.service: search
9+
ms.workload: search
1010
ms.topic: conceptual
11-
ms.date: 11/04/2019
11+
ms.date: 09/18/2019
12+
ms.author: abmotley
1213
---
1314

14-
# Common errors and warnings of the AI enrichment pipeline in Azure Cognitive Search
15+
# Common errors and warnings of the AI enrichment pipeline in Azure Search
1516

16-
This article provides information and solutions to common errors and warnings you might encounter during AI enrichment in Azure Cognitive Search.
17+
This article provides information and solutions to common errors and warnings you might encounter during AI enrichment in Azure Search.
1718

1819
## Errors
1920
Indexing stops when the error count exceeds ['maxFailedItems'](cognitive-search-concept-troubleshooting.md#tip-3-see-what-works-even-if-there-are-some-failures).

articles/search/cognitive-search-concept-annotations-syntax.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
---
2-
title: Reference inputs and outputs in an AI enrichment pipeline
3-
titleSuffix: Azure Cognitive Search
4-
description: Explains the annotation syntax and how to reference an annotation in the inputs and outputs of a skillset in an AI enrichment pipeline in Azure Cognitive Search.
5-
2+
title: Reference inputs and outputs in cognitive search pipelines - Azure Search
3+
description: Explains the annotation syntax and how to reference an annotation in the inputs and outputs of a skillset in a cognitive search pipeline in Azure Search.
4+
services: search
65
manager: nitinme
7-
author: LuisCabrer
8-
ms.author: luisca
9-
ms.service: cognitive-search
6+
author: luiscabrer
7+
8+
ms.service: search
9+
ms.workload: search
1010
ms.topic: conceptual
11-
ms.date: 11/04/2019
11+
ms.date: 05/02/2019
12+
ms.author: luisca
1213
---
13-
# How to reference annotations in an Azure Cognitive Search skillset
14+
# How to reference annotations in a cognitive search skillset
1415

1516
In this article, you learn how to reference annotations in skill definitions, using examples to illustrate various scenarios. As the content of a document flows through a set of skills, it gets enriched with annotations. Annotations can be used as inputs for further downstream enrichment, or mapped to an output field in an index.
1617

0 commit comments

Comments
 (0)