.ingest into

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer

.ingest into 명령은 하나 이상의 클라우드 스토리지 파일에서 데이터를 "끌어와서" 테이블에 데이터를 수집합니다. 예를 들어 이 명령은 Azure Blob Storage에서 1,000개의 CSV 형식 Blob을 검색하고, 구문 분석하고, 단일 대상 테이블로 함께 수집할 수 있습니다. 데이터는 기존 레코드에 영향을 주지 않고 테이블의 스키마를 수정하지 않고 테이블에 추가됩니다.

권한을

이 명령을 실행하려면 적어도 테이블 수집기 권한이 있어야 합니다.

통사론

.ingest [async] intotableTableNameSourceDataLocator [with(IngestionPropertyName=IngestionPropertyValue [, ...] )]

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

수집 속성

다음 표에서는 지원되는 속성을 나열하고 설명하고 예제를 제공합니다.

인증 및 권한 부여

각 스토리지 연결 문자열은 스토리지에 액세스하는 데 사용할 권한 부여 방법을 나타냅니다. 권한 부여 방법에 따라 수집을 수행하려면 보안 주체에게 외부 스토리지에 대한 권한을 부여해야 할 수 있습니다.

다음 표에서는 지원되는 인증 방법 및 외부 스토리지에서 데이터를 수집하는 데 필요한 권한을 나열합니다.

반환

명령의 결과는 명령에 의해 생성된 데이터 분할된 데이터베이스("익스텐트")가 있는 만큼의 레코드가 있는 테이블입니다. 데이터 분할된 데이터베이스가 생성되지 않은 경우 빈(0값) 익스텐트 ID를 사용하여 단일 레코드가 반환됩니다.

예제

공유 액세스 서명이 있는 Azure Blob Storage

다음 예제에서는 데이터베이스에 Azure Blob Storage에서 두 개의 Blob을 CSV 파일로 읽고 해당 내용을 테이블 T수집하도록 지시합니다. ... 각 Blob에 대한 읽기 권한을 제공하는 Azure Storage SAS(공유 액세스 서명)를 나타냅니다. 난독 제거된 문자열(문자열 값 앞에 h)은 SAS가 기록되지 않도록 하는 데 사용됩니다.

.ingest into table T (
    h'https://contoso.blob.core.windows.net/container/file1.csv?...',
    h'https://contoso.blob.core.windows.net/container/file2.csv?...'
)

관리 ID가 있는 Azure Blob Storage

다음 예제에서는 Azure Blob Storage에서 CSV 파일을 읽고 관리 ID 인증을 사용하여 T 테이블에 콘텐츠를 수집하는 방법을 보여 줍니다. 인증은 Azure의 Azure Blob Storage에 할당된 관리 ID(개체 ID)를 사용합니다. 자세한 내용은 스토리지 컨테이너에 대한 관리 ID 만들기를 참조하세요.

.ingest into table T ('https://StorageAccount.blob.core.windows.net/Container/file.csv;managed_identity=802bada6-4d21-44b2-9d15-e66b29e4d63e')

Azure Data Lake Storage Gen 2

다음 예제는 ADLSv2(Azure Data Lake Storage Gen 2)에서 데이터를 수집하는 것입니다. 여기서 사용되는 자격 증명(...)은 스토리지 계정 자격 증명(공유 키)이며 연결 문자열의 비밀 부분에 대해서만 문자열 난독화를 사용합니다.

.ingest into table T (
  'abfss://myfilesystem@contoso.dfs.core.windows.net/path/to/file1.csv;...'
)

Azure Data Lake Storage

다음 예제에서는 ADLS(Azure Data Lake Storage)에서 단일 파일을 수집합니다. 사용자의 자격 증명을 사용하여 ADLS에 액세스하므로 스토리지 URI를 비밀이 포함된 것으로 처리할 필요가 없습니다. 또한 수집 속성을 지정하는 방법도 보여줍니다.

.ingest into table T ('adl://contoso.azuredatalakestore.net/Path/To/File/file1.ext;impersonate')
  with (format='csv')

액세스 키가 있는 Amazon S3

다음 예제에서는 액세스 키 ID 및 비밀 액세스 키사용하여 Amazon S3에서 단일 파일을 수집합니다.

.ingest into table T ('https://bucketname.s3.us-east-1.amazonaws.com/path/to/file.csv;AwsCredentials=AKIAIOSFODNN7EXAMPLE,wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY')
  with (format='csv')

미리 서명된 URL이 있는 Amazon S3

다음 예제에서는 미리 서명된 URL사용하여 Amazon S3에서 단일 파일을 수집합니다.

.ingest into table T ('https://bucketname.s3.us-east-1.amazonaws.com/file.csv?<<pre signed string>>')
  with (format='csv')

관련 콘텐츠

• 수집 지원되는 데이터 형식
• 인라인 .ingest
• 쿼리(.set, .append, .set-or-append, .set-or-replace)
• .show 수집 실패 명령
• .show 수집 매핑