Skip to content

Commit 46ec063

Browse files
Merge pull request #2826 from MicrosoftDocs/main639044209716993790sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents a588a23 + da977ef commit 46ec063

3 files changed

Lines changed: 4 additions & 17 deletions

File tree

data-explorer/kusto/management/data-ingestion/ingest-from-storage-queued.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ with (
7777
```
7878

7979
>[!NOTE]
80-
> Make sure to include a SAS token or use a managed identity to grant the service permission to access and download the blob.
80+
> Make sure to include a SAS token or use a managed identity to grant the service permission to access and download the blob. See [storage connection strings](../../api/connection-strings/storage-connection-strings.md) for details.
8181
8282
### Ingest all blobs in a folder
8383

data-explorer/kusto/management/data-ingestion/list-blobs.md

Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -43,23 +43,11 @@ You must have at least [Table Ingestor](../../access-control/role-based-access-c
4343
> * We recommend using [obfuscated string literals](../../query/scalar-data-types/string.md#obfuscated-string-literals) for *SourceDataLocators* to scrub credentials in internal traces and error messages.
4444
>
4545
> * When used alone, `.list blob` returns up to 1,000 files, regardless of any larger value specified in *MaxFiles*.
46+
>
47+
> * The primary use of `.list blobs` is for queued ingestion which is done asynchronously with no user context. Therefore, [Impersonation](../../api/connection-strings/storage-connection-strings.md#impersonation) isn't supported.
4648
4749
[!INCLUDE [ingestion-properties](../../includes/ingestion-properties.md)]
4850

49-
## Authentication and authorization
50-
51-
Each storage connection string indicates the authorization method to use for access to the storage. Depending on the authorization method, the principal might need to be granted permissions on the external storage to perform the ingestion.
52-
53-
The following table lists the supported authentication methods and the permissions needed for ingesting data from external storage.
54-
55-
|Authentication method|Azure Blob Storage / Data Lake Storage Gen2|Data Lake Storage Gen1|
56-
|--|--|--|
57-
|[Shared Access (SAS) token](../../api/connection-strings/storage-connection-strings.md#shared-access-sas-token)|List + Read|This authentication method isn't supported in Gen1.|
58-
|[Storage account access key](../../api/connection-strings/storage-connection-strings.md#storage-account-access-key)||This authentication method isn't supported in Gen1.|
59-
|[Managed identity](../../api/connection-strings/storage-connection-strings.md#managed-identity)|Storage Blob Data Reader|Reader|
60-
61-
The primary use of `.list blobs` is for queued ingestion which is done asynchronously with no user context. Therefore, [Impersonation](../../api/connection-strings/storage-connection-strings.md#impersonation) isn't supported.
62-
6351
### Path format
6452

6553
The *PathFormat* parameter allows you to specify the format of the creation time for listed blobs. It consists of a sequence of text separators and partition elements. A partition element refers to a partition that is declared in the partition `by` clause, and the text separator is any text enclosed in quotes. Consecutive partition elements must be set apart using the text separator.

data-explorer/kusto/management/data-ingestion/queued-ingest-use-http.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ To use the REST API for queued ingestion, you need:
1616

1717
- **Ingestor** role with **table** scope to ingest data into an existing table.
1818
- **Database User** role to access the target database.
19-
- **Storage Blob Data Reader** role on the blob storage container.
2019

2120
For more information, see [Role-based access control](../../access-control/role-based-access-control.md).
2221

@@ -50,7 +49,7 @@ Each item in the `blobs` array must follow this structure:
5049

5150
|Field|Type|Required|Description|
5251
|--|--|--|--|
53-
|`url`|`string`| :heavy_check_mark: | The URL of the blob to ingest. The service performs light validation on this field.|
52+
|`url`|`string`| :heavy_check_mark: | The URL of the blob to ingest. The service performs light validation on this field. The URL must be accessible by the service. For non-public blobs, include authentication information as part of the URL (for example, SAS token). See [storage connection strings](../../api/connection-strings/storage-connection-strings.md) for details|
5453
|`sourceId`|`Guid`|No|An identifier for the source blob.|
5554
|`rawSize`|`integer`|No|The size of the blob before compression (nullable).|
5655

0 commit comments

Comments
 (0)