Skip to content

Commit

Permalink
Merging changes synced from https://github.com/MicrosoftDocs/dataexpl…
Browse files Browse the repository at this point in the history 
…orer-docs-pr (branch live)
  • Loading branch information
Learn Build Service GitHub App authored and Learn Build Service GitHub App committed Oct 30, 2024
2 parents 69090fd + 6425b5e commit bf8a7d5
Show file tree
Hide file tree
Showing 13 changed files with 23 additions and 23 deletions.
8 changes: 4 additions & 4 deletions data-explorer/kusto/access-control/provision-entra-id-app.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -80,11 +80,11 @@ You've created your Microsoft Entra application and service principal.

```json
{
"appId": "1234abcd-e5f6-g7h8-i9j0-1234kl5678mn",
"appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"displayName": "my-service-principal",
"name": "my-service-principal",
"password": "1234abcd-e5f6-g7h8-i9j0-1234kl5678mn",
"tenant": "1234abcd-e5f6-g7h8-i9j0-1234kl5678mn"
"password": "00001111-aaaa-2222-bbbb-3333cccc4444",
"tenant": "00001111-aaaa-2222-bbbb-3333cccc4444"
}
```

Expand Down Expand Up @@ -126,7 +126,7 @@ Once your application registration is created, you need to grant the correspondi
For example:

```kusto
.add database Logs viewers ('aadapp=1234abcd-e5f6-g7h8-i9j0-1234kl5678mn;9876abcd-e5f6-g7h8-i9j0-1234kl5678mn') 'App Registration'
.add database Logs viewers ('aadapp=00001111-aaaa-2222-bbbb-3333cccc4444;9876abcd-e5f6-g7h8-i9j0-1234kl5678mn') 'App Registration'
```

The last parameter is a string that shows up as notes when you query the roles associated with a database.
Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/api/connection-strings/sql-connection-strings.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ For a system-assigned managed identity, append `;Authentication="Active Director
| Managed identity type | Example |
|--|--|
| System-assigned | `"Server=tcp:myserver.database.windows.net,1433;Authentication="Active Directory Managed Identity";Initial Catalog=mydatabase;"` |
| User-assigned | `"Server=tcp:myserver.database.windows.net,1433;Authentication="Active Directory Managed Identity";User Id=9ca5bb85-1c1f-44c3-b33a-0dfcc7ec5f6b;Initial Catalog=mydatabase;"` |
| User-assigned | `"Server=tcp:myserver.database.windows.net,1433;Authentication="Active Directory Managed Identity";User Id=00aa00aa-bb11-cc22-dd33-44ee44ee44ee;Initial Catalog=mydatabase;"` |

::: moniker-end

Expand Down
4 changes: 2 additions & 2 deletions data-explorer/kusto/api/get-started/app-basic-query.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ In your preferred IDE or text editor, create a project or file named *basic quer
async function main() {
const clusterUri = "https://help.kusto.windows.net";
const authOptions = {
clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
redirectUri: "http://localhost:5173",
} as InteractiveBrowserCredentialInBrowserOptions;
const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
Expand Down Expand Up @@ -304,7 +304,7 @@ import { InteractiveBrowserCredentialInBrowserOptions } from "@azure/identity";
async function main() {
const clusterUri = "https://help.kusto.windows.net";
const authOptions = {
clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
redirectUri: "http://localhost:5173",
} as InteractiveBrowserCredentialInBrowserOptions;
const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
Expand Down
4 changes: 2 additions & 2 deletions data-explorer/kusto/api/get-started/app-hello-kusto.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ In your preferred IDE or text editor, create a project or file named *hello kust
```typescript
const clusterUri = "https://help.kusto.windows.net";
const authOptions = {
clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
redirectUri: "http://localhost:5173",
} as InteractiveBrowserCredentialInBrowserOptions;
const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
Expand Down Expand Up @@ -365,7 +365,7 @@ async function main()
{
const clusterUri = "https://help.kusto.windows.net";
const authOptions = {
clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
redirectUri: "http://localhost:5173",
} as InteractiveBrowserCredentialInBrowserOptions;
const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
Expand Down
4 changes: 2 additions & 2 deletions data-explorer/kusto/api/get-started/app-management-commands.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ In your preferred IDE or text editor, create a project or file named *management
async function main() {
const clusterUri = "<your_cluster_uri>";
const authOptions = {
clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
redirectUri: "http://localhost:5173",
} as InteractiveBrowserCredentialInBrowserOptions;
const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
Expand Down Expand Up @@ -408,7 +408,7 @@ import { InteractiveBrowserCredentialInBrowserOptions } from "@azure/identity";
async function main() {
const clusterUri = "<your_cluster_uri>";
const authOptions = {
clientId: "5e39af3b-ba50-4255-b547-81abfb507c58",
clientId: "00001111-aaaa-2222-bbbb-3333cccc4444",
redirectUri: "http://localhost:5173",
} as InteractiveBrowserCredentialInBrowserOptions;
const kcsb = KustoConnectionStringBuilder.withUserPrompt(clusterUri, authOptions);
Expand Down
6 changes: 3 additions & 3 deletions data-explorer/kusto/api/monaco/host-web-ux-in-iframe.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@ To embed a dashboard, a trust relationship must be established between the host'

```json
{
"resourceAppId": "35e917a9-4d95-4062-9d97-5781291353b9",
"resourceAppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"resourceAccess": [
{
"id": "388e2b3a-fdb8-4f0b-ae3e-0692ca9efc1c",
Expand All @@ -134,7 +134,7 @@ To embed a dashboard, a trust relationship must be established between the host'
}
```

- `35e917a9-4d95-4062-9d97-5781291353b9` is the application ID of Azure Data Explorer dashboard service.
- `00001111-aaaa-2222-bbbb-3333cccc4444` is the application ID of Azure Data Explorer dashboard service.
- `388e2b3a-fdb8-4f0b-ae3e-0692ca9efc1c` is the user_impersonation permission.

1. In the **Manifest**, save your changes.
Expand All @@ -143,7 +143,7 @@ To embed a dashboard, a trust relationship must be established between the host'
1. In Azure PowerShell, add the following new service principal for the app:

```powershell
New-MgServicePrincipal -AppId 35e917a9-4d95-4062-9d97-5781291353b9
New-MgServicePrincipal -AppId 00001111-aaaa-2222-bbbb-3333cccc4444
```


Expand Down
4 changes: 2 additions & 2 deletions data-explorer/kusto/api/rest/authenticate-with-msal.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,8 @@ During the token acquisition process, the client needs to provide the following
|Parameter name|Description|
|--|--|
|Resource ID|The resource ID for which to issue the Microsoft Entra access token. The resource ID is the cluster URI without port information and path.<br/><br/>**Example**: The resource ID for the `help` cluster is `https://help.kusto.windows.net`.|
|Microsoft Entra tenant ID|Microsoft Entra ID is a multitenant service, and every organization can create an object called a directory that holds security-related objects such as user accounts and applications. Microsoft Entra ID often refers to the directory as a tenant. Each tenant has a tenant ID in the form of a GUID. In many cases, the domain name of the organization might also be used to identity the Microsoft Entra tenant.<br/><br/>**Example**: An organization "Contoso" might have the tenant ID `12345678-a123-4567-b890-123a456b789c` and the domain name `contoso.com`.|
|Microsoft Entra authority URI|The endpoint used for authentication. The Microsoft Entra directory, or tenant, determines the Microsoft Entra authority URI. The URI is `https://login.microsoftonline.com/{tenantId}` where `{tenantId}` is either the tenant ID or domain name.<br/><br/>**Example**: For example, `https://login.microsoftonline.com/12345678-a123-4567-b890-123a456b789c`.|
|Microsoft Entra tenant ID|Microsoft Entra ID is a multitenant service, and every organization can create an object called a directory that holds security-related objects such as user accounts and applications. Microsoft Entra ID often refers to the directory as a tenant. Each tenant has a tenant ID in the form of a GUID. In many cases, the domain name of the organization might also be used to identity the Microsoft Entra tenant.<br/><br/>**Example**: An organization "Contoso" might have the tenant ID `aaaabbbb-0000-cccc-1111-dddd2222eeee` and the domain name `contoso.com`.|
|Microsoft Entra authority URI|The endpoint used for authentication. The Microsoft Entra directory, or tenant, determines the Microsoft Entra authority URI. The URI is `https://login.microsoftonline.com/{tenantId}` where `{tenantId}` is either the tenant ID or domain name.<br/><br/>**Example**: For example, `https://login.microsoftonline.com/aaaabbbb-0000-cccc-1111-dddd2222eeee`.|

> [!NOTE]
> The Microsoft Entra service endpoint changes in national clouds. When working with an Azure Data Explorer service deployed in a national cloud, set the corresponding national cloud Microsoft Entra service endpoint.
Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/alter-managed-identity-policy-command.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ If any of the specified managed identities isn't assigned to the cluster, an err
.alter database db policy managed_identity ```
[
{
"ObjectId": "d99c9846-1615-a2f9-a96f-78e136ba93eb",
"ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"AllowedUsages": "NativeIngestion, ExternalTable"
}
]```
Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ If any of the specified managed identities isn't assigned to the cluster, an err
.alter-merge database db policy managed_identity ```
[
{
"ObjectId": "d99c9846-1615-a2f9-a96f-78e136ba93eb",
"ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"AllowedUsages": "NativeIngestion, ExternalTable"
}
]
Expand Down
2 changes: 1 addition & 1 deletion ...r/kusto/management/materialized-views/materialized-view-show-details-command.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -75,4 +75,4 @@ The following command shows details for materialized view OperationsView:

| MaterializedViewName | DatabaseName | Folder | DocString | TotalExtents | TotalExtentSize | TotalOriginalSize | TotalRowCount | HotExtents | HotExtentSize | HotOriginalSize | HotRowCount | AuthorizedPrincipals | RetentionPolicy | CachingPolicy | ShardingPolicy |MergePolicy | MinExtentsCreationTime | MaxExtentsCreationTime |
|----------------------|--------------|--------|-----------|--------------|-----------------|-------------------|---------------|------------|---------------|-----------------|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------|-----------------------------|
| OperationsView | Operations | | | 1109 | 76588803 | 91553069 | 110125 | 27 | 2635742 | 2929926 | 3162 | [{"Type": "AAD User", "DisplayName": "My Name (upn: [email protected])", "ObjectId": "a7a77777-4c21-4649-95c5-350bf486087b", "FQN": "aaduser=a7a77777-4c21-4649-95c5-350bf486087b", "Notes": ""}] | { "SoftDeletePeriod": "365.00:00:00", "ContainerRecyclingPeriod": "1.00:00:00", "ExtentsDataSizeLimitInBytes": 0, "OriginalDataSizeLimitInBytes": 0 } | { "DataHotSpan": "4.00:00:00", "IndexHotSpan": "4.00:00:00", "ColumnOverrides": [] } | { "MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048 } | { "RowCountUpperBoundForMerge": 0, "MaxExtentsToMerge": 100, "LoopPeriod": "01:00:00", "MaxRangeInHours": 3, "AllowRebuild": true, "AllowMerge": true } | 2023-02-08 15:30:38.8489786 | 2023-02-14 07:47:28.7660267 |
| OperationsView | Operations | | | 1109 | 76588803 | 91553069 | 110125 | 27 | 2635742 | 2929926 | 3162 | [{"Type": "AAD User", "DisplayName": "My Name (upn: [email protected])", "ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "FQN": "aaduser=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "Notes": ""}] | { "SoftDeletePeriod": "365.00:00:00", "ContainerRecyclingPeriod": "1.00:00:00", "ExtentsDataSizeLimitInBytes": 0, "OriginalDataSizeLimitInBytes": 0 } | { "DataHotSpan": "4.00:00:00", "IndexHotSpan": "4.00:00:00", "ColumnOverrides": [] } | { "MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048 } | { "RowCountUpperBoundForMerge": 0, "MaxExtentsToMerge": 100, "LoopPeriod": "01:00:00", "MaxRangeInHours": 3, "AllowRebuild": true, "AllowMerge": true } | 2023-02-08 15:30:38.8489786 | 2023-02-14 07:47:28.7660267 |
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/show-managed-identity-policy-command.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -51,4 +51,4 @@ This command returns a table that has a single record.

| EntityName | Policies |
|--------------|----------|
| [MyDatabase] | [{"ObjectId": "f687680c-5ba0-4025-ab04-0433fdbd0086", "ClientId": "7c8fee41-97d1-4ebd-9140-32a3b8316820", "TenantId": "4549d41b-a99d-4367-a887-7dd2c00e542c", "DisplayName": "myManagedIdentity", "IsSystem": false, "AllowedUsages": "NativeIngestion, ExternalTable"}] |
| [MyDatabase] | [{"ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "ClientId": "00001111-aaaa-2222-bbbb-3333cccc4444", "TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "DisplayName": "myManagedIdentity", "IsSystem": false, "AllowedUsages": "NativeIngestion, ExternalTable"}] |
4 changes: 2 additions & 2 deletions data-explorer/kusto/management/show-table-details-command.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -67,8 +67,8 @@ You must have at least Database User, Database Viewer, or Database Monitor permi

| TableName | DatabaseName | Folder | DocString | TotalExtents | TotalExtentSize | TotalOriginalSize | TotalRowCount | HotExtents | HotExtentSize | HotOriginalSize | HotRowCount | AuthorizedPrincipals | RetentionPolicy | CachingPolicy | ShardingPolicy | MergePolicy | StreamingIngestionPolicy | IngestionBatchingPolicy | MinExtentsCreationTime | MaxExtentsCreationTime | TableID |
|-------------------|--------------|--------|-----------|--------------|-----------------|-------------------|---------------|------------|---------------|-----------------|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|-------------------------|-----------------------------|-----------------------------|-------------------------------|
| Operations | Operations | | | 1164 | 37687203 | 53451358 | 223325 | 29 | 838752 | 1388213 | 5117 | [{"Type": "AAD User", "DisplayName": "My Name (upn: [email protected])", "ObjectId": "a7a77777-4c21-4649-95c5-350bf486087b", "FQN": "aaduser=a7a77777-4c21-4649-95c5-350bf486087b", "Notes": ""}] | {"SoftDeletePeriod": "365.00:00:00", "ContainerRecyclingPeriod": "1.00:00:00", "ExtentsDataSizeLimitInBytes": 0, "OriginalDataSizeLimitInBytes": 0 } | { "DataHotSpan": "4.00:00:00", "IndexHotSpan": "4.00:00:00", "ColumnOverrides": [] } | { "MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048 } | { "RowCountUpperBoundForMerge": 0, "MaxExtentsToMerge": 100, "LoopPeriod": "01:00:00", "MaxRangeInHours": 3, "AllowRebuild": true, "AllowMerge": true } | null | null | | | 99490f60-ba91-4188-a9ad-7ce3c0cc2b0c |
| ServiceOperations | Operations | | | 1109 | 76588803 | 91553069 | 110125 | 27 | 2635742 | 2929926 | 3162 | [{"Type": "AAD User", "DisplayName": "My Name (upn: [email protected])", "ObjectId": "a7a77777-4c21-4649-95c5-350bf486087b", "FQN": "aaduser=a7a77777-4c21-4649-95c5-350bf486087b", "Notes": ""}] | { "SoftDeletePeriod": "365.00:00:00", "ContainerRecyclingPeriod": "1.00:00:00", "ExtentsDataSizeLimitInBytes": 0, "OriginalDataSizeLimitInBytes": 0 } | { "DataHotSpan": "4.00:00:00", "IndexHotSpan": "4.00:00:00", "ColumnOverrides": [] } | { "MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048 } | { "RowCountUpperBoundForMerge": 0, "MaxExtentsToMerge": 100, "LoopPeriod": "01:00:00", "MaxRangeInHours": 3, "AllowRebuild": true, "AllowMerge": true } | null | null | 2018-02-08 15:30:38.8489786 | 2018-02-14 07:47:28.7660267 | 873a0f60-97c1-8158-daad-b0cce73c0cc2 |
| Operations | Operations | | | 1164 | 37687203 | 53451358 | 223325 | 29 | 838752 | 1388213 | 5117 | [{"Type": "AAD User", "DisplayName": "My Name (upn: [email protected])", "ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "FQN": "aaduser=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "Notes": ""}] | {"SoftDeletePeriod": "365.00:00:00", "ContainerRecyclingPeriod": "1.00:00:00", "ExtentsDataSizeLimitInBytes": 0, "OriginalDataSizeLimitInBytes": 0 } | { "DataHotSpan": "4.00:00:00", "IndexHotSpan": "4.00:00:00", "ColumnOverrides": [] } | { "MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048 } | { "RowCountUpperBoundForMerge": 0, "MaxExtentsToMerge": 100, "LoopPeriod": "01:00:00", "MaxRangeInHours": 3, "AllowRebuild": true, "AllowMerge": true } | null | null | | | bbbbbbbb-1111-2222-3333-cccccccccccc |
| ServiceOperations | Operations | | | 1109 | 76588803 | 91553069 | 110125 | 27 | 2635742 | 2929926 | 3162 | [{"Type": "AAD User", "DisplayName": "My Name (upn: [email protected])", "ObjectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "FQN": "aaduser=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "Notes": ""}] | { "SoftDeletePeriod": "365.00:00:00", "ContainerRecyclingPeriod": "1.00:00:00", "ExtentsDataSizeLimitInBytes": 0, "OriginalDataSizeLimitInBytes": 0 } | { "DataHotSpan": "4.00:00:00", "IndexHotSpan": "4.00:00:00", "ColumnOverrides": [] } | { "MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048 } | { "RowCountUpperBoundForMerge": 0, "MaxExtentsToMerge": 100, "LoopPeriod": "01:00:00", "MaxRangeInHours": 3, "AllowRebuild": true, "AllowMerge": true } | null | null | 2018-02-08 15:30:38.8489786 | 2018-02-14 07:47:28.7660267 | cccccccc-2222-3333-4444-dddddddddddd |

## Related content

Expand Down
Loading

0 comments on commit bf8a7d5

Please sign in to comment.