CSV 매핑

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

CSV 매핑을 사용하여 수집 원본 파일이 구분 기호로 구분된 테이블 형식인 경우 들어오는 데이터를 테이블 내의 열에 매핑합니다. CSV, TSV, PSV, SCSV, SOHsv, TXT 및 RAW. 자세한 내용은 지원되는 데이터 형식을 참조하세요.

매핑 목록의 각 요소는 특정 열에 대한 매핑을 정의합니다. 이러한 요소는 세 가지 column속성인 , datatype및 properties.에서 생성됩니다. 데이터 매핑 개요에 대해 자세히 알아봅니다.

각 CSV 매핑 요소는 다음 선택적 속성 중 하나를 포함해야 합니다.

속성	Type	설명
Ordinal	int	CSV의 열 순서 번호입니다.
ConstValue	string	CSV 파일 내의 일부 값 대신 열에 사용할 상수 값입니다.
변환	string	매핑 변환을 사용하여 콘텐츠 에 적용해야 하는 변환입니다. 유일하게 지원되는 변환은 .입니다 SourceLocation.

참고 항목

• 변환을 SourceLocation 사용하는 Ordinal 경우 ConstValue 설정되지 않아야 합니다.
• TXT 및 RAW 형식의 경우 텍스트가 단일 줄 열로 처리되므로 0만 Ordinal 매핑할 수 있습니다.

Important

대기 중인 수집의 경우:

• 매핑에서 참조되는 테이블이 데이터베이스에 없는 경우 모든 열에 대해 유효한 데이터 형식이 지정되어 있으면 자동으로 만들어집니다.
• 매핑에서 참조되는 열이 테이블에 없는 경우 열에 대해 유효한 데이터 형식이 지정된 경우 해당 열에 대한 데이터를 처음 수집할 때 마지막 열로 테이블에 자동으로 추가됩니다. 매핑에 새 열을 추가하려면 .alter 수집 매핑 명령을 사용합니다.
• 데이터는 수집 속성을 사용하여 일괄 처리됩니다. 다른 ConstValue 값과 같이 사용되는 고유 수집 매핑 속성이 많을수록 수집이 조각화되어 성능이 저하될 수 있습니다.

예제

[
  {"Column": "event_time", "Properties": {"Ordinal": "0"}},
  {"Column": "event_name", "Properties": {"Ordinal": "1"}},
  {"Column": "event_type", "Properties": {"Ordinal": "2"}},
  {"Column": "ingestion_time", "Properties": {"ConstValue": "2023-01-01T10:32:00"}}
  {"Column": "source_location", "Properties": {"Transform": "SourceLocation"}}
]

위의 매핑은 관리 명령의 .ingest 일부로 제공되는 경우 JSON 문자열로 직렬화됩니다.

.ingest into Table123 (@"source1", @"source2")
    with
    (
        format="csv",
        ingestionMapping =
        ```
        [
            {"Column": "event_time", "Properties": {"Ordinal": "0"}},
            {"Column": "event_name", "Properties": {"Ordinal": "1"}},
            {"Column": "event_type", "Properties": {"Ordinal": "2"}},
            {"Column": "ingestion_time", "Properties": {"ConstValue": "2023-01-01T10:32:00"}},
            {"Column": "source_location", "Properties": {"Transform": "SourceLocation"}}
        ]
        ```
    )

미리 만든 매핑

매핑이 미리 만들어지면 관리 명령에서 이름으로 매핑을 .ingest 참조합니다.

.ingest into Table123 (@"source1", @"source2")
    with
    (
        format="csv",
        ingestionMappingReference = "MappingName"
    )

ID 매핑

매핑 스키마를 정의하지 않고 수집 중에 CSV 매핑을 사용합니다(ID 매핑 참조).

.ingest into Table123 (@"source1", @"source2")
    with
    (
        format="csv"
    )