fix: em dash spacing + Bicep param validation (round 3)

- Remove spaces around 13 em dashes in README per Microsoft Learn standards
- Add @minlength(36)/@maxlength(36) to deploymentUserPrincipalId in main.bicep
  to catch missing AZURE_PRINCIPAL_ID early with clear validation error

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: diberry

samples/features/vector-search/infra/main.bicep

@@ -26,7 +26,9 @@ param environmentName string
 })
 param location string
 
-@description('Id of the principal to assign database and application roles.')
+@description('Object ID of the principal to assign database and application roles. Required — must be set via AZURE_PRINCIPAL_ID. Expected as UUID (36 characters).')
+@minLength(36)
+@maxLength(36)
 param deploymentUserPrincipalId string = ''
 
 @description('Client IP address for SQL firewall rule (for local development).')

samples/features/vector-search/vector-search-query-typescript/README.md

@@ -32,15 +32,15 @@ This sample supports two algorithms, selected via the `VECTOR_SEARCH_ALGORITHM`
 | **Best for** | < 50,000 rows, prototyping | > 10,000 rows, production |
 
 > [!IMPORTANT]
-> DiskANN index creation requires at least **1,000 rows** with non-null vectors. The 50-hotel sample dataset is too small — load a larger dataset before using `VECTOR_SEARCH_ALGORITHM=diskann`.
+> DiskANN index creation requires at least **1,000 rows** with non-null vectors. The 50-hotel sample dataset is too small—load a larger dataset before using `VECTOR_SEARCH_ALGORITHM=diskann`.
 
 ## Prerequisites
 
-- **Azure subscription** — [Create one free](https://azure.microsoft.com/free/)
-- **Azure SQL Database** with native vector support — [Quickstart: Create a single database](https://learn.microsoft.com/azure/azure-sql/database/single-database-create-quickstart)
-- **Azure OpenAI resource** with a `text-embedding-3-small` deployment — [Create and deploy an Azure OpenAI Service resource](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource)
-- **Node.js 20+** — [Download Node.js](https://nodejs.org/)
-- **Azure CLI** — [Install the Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli), signed in with `az login`
+- **Azure subscription**—[Create one free](https://azure.microsoft.com/free/)
+- **Azure SQL Database** with native vector support—[Quickstart: Create a single database](https://learn.microsoft.com/azure/azure-sql/database/single-database-create-quickstart)
+- **Azure OpenAI resource** with a `text-embedding-3-small` deployment—[Create and deploy an Azure OpenAI Service resource](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource)
+- **Node.js 20+**—[Download Node.js](https://nodejs.org/)
+- **Azure CLI**—[Install the Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli), signed in with `az login`
 
 > [!IMPORTANT]
 > Your Azure identity must be configured as a **Microsoft Entra admin** on the Azure SQL server. The `azd up` deployment sets this automatically using `deploymentUserPrincipalId`. For the Azure OpenAI resource, you need the **Cognitive Services OpenAI User** role.
@@ -220,7 +220,7 @@ const response = await openaiClient.embeddings.create({
 
 ### Vector similarity search
 
-**Exact search (default)** — The `VECTOR_DISTANCE()` function computes cosine distance between the query vector and all stored embeddings:
+**Exact search (default)**—The `VECTOR_DISTANCE()` function computes cosine distance between the query vector and all stored embeddings:
 
 ```sql
 SELECT TOP 3
@@ -230,7 +230,7 @@ FROM dbo.hotels_typescript
 ORDER BY distance;
 ```
 
-**Approximate search (DiskANN)** — The `VECTOR_SEARCH()` function uses a DiskANN index for 10–100× faster queries on large datasets:
+**Approximate search (DiskANN)**—The `VECTOR_SEARCH()` function uses a DiskANN index for 10–100× faster queries on large datasets:
 
 ```sql
 SELECT TOP 3
@@ -275,13 +275,13 @@ To avoid ongoing charges, delete the Azure resources you created if they were on
 
 ### Authentication failures
 
-**"Login failed"** — Ensure your Azure identity is set as Microsoft Entra admin on the SQL server. Run `az login` to refresh your credentials.
+**"Login failed"**—Ensure your Azure identity is set as Microsoft Entra admin on the SQL server. Run `az login` to refresh your credentials.
 
-**"AuthenticationError" from Azure OpenAI** — Verify you have the **Cognitive Services OpenAI User** role on the Azure OpenAI resource. Check the endpoint URL and deployment name in your `.env` file.
+**"AuthenticationError" from Azure OpenAI**—Verify you have the **Cognitive Services OpenAI User** role on the Azure OpenAI resource. Check the endpoint URL and deployment name in your `.env` file.
 
 ### Firewall errors
 
-**"Cannot open server"** — Your client IP may not be in the SQL firewall rules. Add it:
+**"Cannot open server"**—Your client IP may not be in the SQL firewall rules. Add it:
 
 ```bash
 az sql server firewall-rule create \
@@ -291,15 +291,15 @@ az sql server firewall-rule create \
 
 ### DiskANN errors
 
-**"DiskANN index requires at least 1,000 rows"** — The 50-hotel sample dataset is too small for DiskANN. The sample automatically detects this and falls back to exact nearest-neighbor search using `VECTOR_DISTANCE` without a vector index. To use DiskANN, load a larger dataset first.
+**"DiskANN index requires at least 1,000 rows"**—The 50-hotel sample dataset is too small for DiskANN. The sample automatically detects this and falls back to exact nearest-neighbor search using `VECTOR_DISTANCE` without a vector index. To use DiskANN, load a larger dataset first.
 
 ### Vector dimension errors
 
 **"Invalid or missing vector dimensions"**—The precomputed embeddings in `HotelsData_Vector.json` must use 1536 dimensions (matching `text-embedding-3-small`). Re-run `npm run embed` if you changed the embedding model.
 
 ## Explore your database
 
-To browse tables, run queries, and inspect vector data directly from VS Code, install the [SQL Server (mssql)](https://marketplace.visualstudio.com/items?itemName=ms-mssql.mssql) extension. Connect using your Azure AD credentials — the same authentication the sample uses.
+To browse tables, run queries, and inspect vector data directly from VS Code, install the [SQL Server (mssql)](https://marketplace.visualstudio.com/items?itemName=ms-mssql.mssql) extension. Connect using your Azure AD credentials—the same authentication the sample uses.
 
 ## Related content