다음을 통해 공유

.create-or-alter ingestion mapping 명령

  • 아티클

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

특정 형식 및 특정 테이블 또는 데이터베이스와 연결할 수 있는 수집 매핑을 만들거나 변경합니다.

수집 매핑이 없으면 명령에서 매핑을 만듭니다. 수집 매핑이 이미 있는 경우 명령은 이를 수정합니다.

참고 항목

원본 테이블에 없는 수집 매핑에 도입된 새 열은 해당 열에 대한 초기 데이터 수집 중에 테이블에 추가됩니다. 이 동작은 대기 중인 수집에 대해서만 지원되며 열에 유효한 데이터 형식을 지정하는 데 따라 달라집니다.

사용 권한

데이터베이스 수집 매핑을 만들려면 데이터베이스 수집 권한 이상이 필요하며 테이블 수집 매핑을 만들려면 테이블 수집 권한 이상이 필요합니다.

구문

.create-or-altertable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.create-or-alterdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

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

매개 변수

이름 Type 필수 설명
TableName string ✔️ 테이블의 이름입니다.
DatabaseName string ✔️ 데이터베이스의 이름입니다.
MappingKind string ✔️ 매핑의 형식입니다. 유효한 값은 CSV, JSON, avro, parquet, orc입니다.
MappingName string ✔️ 매핑 이름입니다.
MappingFormattedAsJson string ✔️ JSON 값으로 형식이 지정된 수집 매핑 정의입니다.

참고 항목

  • 매핑을 만든 후에는 명령의 일부로 전체 매핑을 지정하는 대신 수집 명령에서 해당 이름으로 매핑을 참조할 수 있습니다.
  • 테이블 범위와 데이터베이스 범위 모두에서 이름이 같은 매핑이 만들어지면 테이블 범위의 매핑 우선 순위가 높아집니다.
  • 테이블을 수집하고 스키마가 수집된 테이블 스키마와 일치하지 않는 매핑을 참조하는 경우 수집 작업이 실패합니다.

예시

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
'    { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
'    { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'

출력

속성 종류 매핑 데이터베이스 테이블
mapping1 JSON [{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}] MyDatabase MyTable

관련 콘텐츠

  • CSV, JSON, Avro, Parquet 및 Orc와 같은 다양한 수집 매핑 형식에 대한 자세한 설명은 데이터 매핑을 참조 하세요.