다음을 통해 공유

.create ingestion mapping 명령

  • 아티클

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

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

지정된 범위에서 이름이 같은 매핑이 이미 있는 경우 실패합니다 .create . 대신 .create-or-alter를 사용하세요.

사용 권한

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

구문

.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.createdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

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

매개 변수

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

참고 항목

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

예제

CSV 수집 매핑을 사용하여 테이블 및 데이터베이스 만들기

다음 예제에서는 CSV 수집 매핑 Mapping1 및 데이터베이스 MyDatabase 를 사용하여 CSV 수집 매핑Mapping2을 사용하여 테이블을 MyTable 만듭니다.

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

.create database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

출력

속성 종류 매핑 데이터베이스 테이블
mapping1 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase MyTable
mapping2 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase

이스케이프 문자를 사용하여 수집 매핑 만들기

다음 예제에서는 JSON 수집 매핑test_mapping_name을 사용하여 테이블을 test_table 만듭니다. 오류를 방지하기 위해 백슬라이시는 JSON 경로 문자열에서 작은따옴표를 이스케이프하는 데 사용됩니다.

.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'

관련 콘텐츠

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