중요합니다
Azure Synapse Analytics 데이터 탐색기(미리 보기)는 2025년 10월 7일에 사용 중지됩니다. 이 날짜 이후에는 Synapse 데이터 탐색기에서 실행되는 워크로드가 삭제되고 연결된 애플리케이션 데이터가 손실됩니다. Microsoft Fabric의 Eventhouse로 마이그레이션하는 것이 좋습니다.
Microsoft CMF(Cloud Migration Factory) 프로그램은 고객이 패브릭으로 마이그레이션할 수 있도록 지원하도록 설계되었습니다. 이 프로그램은 고객에게 비용 없이 실습 키보드 리소스를 제공합니다. 이러한 리소스는 미리 정의되고 합의된 범위로 6~8주 동안 할당됩니다. 고객 추천은 Microsoft 계정 팀에서 또는 CMF 팀에 도움말 요청을 제출하여 직접 수락됩니다.
데이터 수집은 데이터가 테이블에 추가되고 데이터 탐색기에서 쿼리에 사용할 수 있게 되는 프로세스입니다. 키워드 뒤의 수집 명령에 속성을 추가합니다 with .
섭취 속성
다음 표에서는 데이터 탐색기에서 지원하는 속성을 나열하고, 설명하고, 예제를 제공합니다.
| 재산 | Description | 예시 |
|---|---|---|
ingestionMapping |
원본 파일의 데이터를 테이블의 실제 열에 매핑하는 방법을 나타내는 문자열 값입니다.
format 관련 매핑 형식을 사용하여 값을 정의합니다.
데이터 매핑을 참조하세요. |
with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")(사용되지 않음: avroMapping, csvMapping) jsonMapping |
ingestionMappingReference |
명명된 매핑 정책 개체를 사용하여 원본 파일의 데이터를 테이블의 실제 열에 매핑하는 방법을 나타내는 문자열 값입니다.
format 관련 매핑 형식을 사용하여 값을 정의합니다.
데이터 매핑을 참조하세요. |
with (format="csv", ingestionMappingReference = "Mapping1")(사용되지 않음: avroMappingReference, csvMappingReference) jsonMappingReference |
creationTime |
수집된 데이터 익스텐트의 생성 시간에 사용할 날짜/시간 값(ISO8601 문자열 형식)입니다. 지정하지 않으면 현재 값(now())이 사용됩니다. 기본값 재정의는 보존 정책이 올바르게 적용되도록 이전 데이터를 수집할 때 유용합니다. 지정한 경우 대상 테이블의 유효 Lookback의 속성이 지정된 값과 일치하는지 확인 합니다. |
with (creationTime="2017-02-13") |
extend_schema |
지정한 경우 명령이 테이블의 스키마를 확장하도록 지시하는 부울 값입니다(기본값은 false). 이 옵션은 명령에만 .append.set-or-append 적용됩니다. 허용되는 유일한 스키마 확장에는 마지막에 테이블에 추가된 추가 열이 있습니다. |
원래 테이블 스키마인 (a:string, b:int)경우 유효한 스키마 확장 (a:string, b:int, c:datetime, d:string)은 유효하지만 (a:string, c:datetime) 유효하지는 않습니다. |
folder |
쿼리에서 수집 명령의 경우 테이블에 할당할 폴더입니다. 테이블이 이미 있는 경우 이 속성은 테이블의 폴더를 재정의합니다. | with (folder="Tables/Temporary") |
format |
데이터 형식( 지원되는 데이터 형식 참조)입니다. | with (format="csv") |
ingestIfNotExists |
동일한 값의 ingest-by: 태그가 이미 있는 데이터가 테이블에 존재하는 경우, 수집이 실패하도록 하는 문자열 값입니다. 지정한 경우. 이렇게 하여 idempotent 데이터 수집이 보장됩니다. 자세한 내용은 ingest-by: 태그를 참조하세요. |
속성 with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') 은 태그 ingest-by:Part0001 가 있는 데이터가 이미 있는 경우 현재 수집을 완료하지 않음을 나타냅니다. 아직 없는 경우 이 새 수집에는 이 태그가 설정되어 있어야 합니다(향후 수집에서 동일한 데이터를 다시 수집하려고 시도하는 경우). |
ignoreFirstRecord |
로 설정 true하면 수집에서 모든 파일의 첫 번째 레코드를 무시해야 함을 나타내는 부울 값입니다. 이 속성은 파일의 첫 번째 레코드가 CSV열 이름인 경우 파일 및 유사한 형식의 파일에 유용합니다. 기본적으로 가정 false 됩니다. |
with (ignoreFirstRecord=false) |
persistDetails |
명령이 성공 여부와 상관없이 자세한 결과를 유지해야 한다는 것을 나타내는 부울 값으로, 지정된 경우 .show 작업 세부 정보 명령이 그 결과를 검색할 수 있습니다. 기본값은 false입니다. |
with (persistDetails=true) |
policy_ingestiontime |
지정된 경우 이 명령으로 만든 테이블에서 수집 시간 정책을 사용할지 여부를 설명하는 부울 값입니다. 기본값은 true입니다. |
with (policy_ingestiontime=false) |
recreate_schema |
지정된 경우 명령이 테이블의 스키마를 다시 만들 수 있는지 여부를 설명하는 부울 값입니다. 이 속성은 .set-or-replace 명령에만 적용됩니다. 이 속성은 둘 다 설정된 경우 속성보다 extend_schema 우선합니다. |
with (recreate_schema=true) |
tags |
수집된 데이터와 연결할 태그 목록으로, JSON 문자열로 형식이 지정됩니다. | with (tags="['Tag1', 'Tag2']") |
validationPolicy |
데이터 수집 중에 실행할 유효성 검사를 나타내는 JSON 문자열입니다. 다양한 옵션에 대한 설명은 데이터 수집 을 참조하세요. |
with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (이것은 실제로 기본 정책) |
zipPattern |
ZIP 보관 파일이 있는 스토리지에서 데이터를 수집할 때 이 속성을 사용합니다. ZIP 보관 파일에서 수집할 파일을 선택할 때 사용할 정규식을 나타내는 문자열 값입니다. 보관 파일의 다른 모든 파일은 무시됩니다. | with (zipPattern="*.csv") |
다음 단계
- 데이터 수집에 대해 자세히 알아봅니다.
- 지원되는 데이터 형식에 대해 자세히 알아봅니다.