Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Repo sync for protected branch #2428

Merged
merged 4 commits into from
Oct 30, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions data-explorer/kusto/access-control/provision-entra-id-app.md
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
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
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
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
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
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
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
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
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
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 |
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
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