CSV-leképezés

A CSV-leképezés használatával a bejövő adatokat táblákon belüli oszlopokra képezheti le, ha a betöltési forrásfájl a következő elválasztott táblázatos formátumok bármelyike: CSV, TSV, PSV, SCSV, SOHsv, TXT és RAW. További információ: Támogatott adatformátumok.

A leképezési lista minden eleme meghatározza egy adott oszlop leképezését. Ezek az elemek három tulajdonságból épülnek fel: column, datatypeés properties. További információ az adatleképezések áttekintésében.

Minden CSV-leképezési elemnek tartalmaznia kell a következő választható tulajdonságok egyikét:

Tulajdonság	Típus	Description
Sorszám	int	Az oszlopsorrend száma a CSV-ben.
ConstValue	string	A CSV-fájlban lévő érték helyett egy oszlophoz használandó állandó érték.
Átalakítás	string	Átalakítás, amelyet leképezési átalakításokkal kell alkalmazni a tartalomra. Az egyetlen támogatott átalakítás a következő szerint: SourceLocation.

Megjegyzés

• Ha ConstValue vagy SourceLocation átalakítást használ, Ordinal azt le kell bontani.
• TXT és RAW formátumok esetén csak Ordinal 0 képezhető le, mivel a szöveg egyetlen soroszlopként van kezelve.

Fontos

Várólista-betöltéshez:

• Ha a leképezésben hivatkozott tábla nem létezik az adatbázisban, automatikusan létrejön, mivel minden oszlophoz érvényes adattípusok vannak megadva.
• Ha a megfeleltetésben hivatkozott oszlop nem létezik a táblában, a rendszer automatikusan hozzáadja azt a táblához, mint az oszlop első adatbetöltésének utolsó oszlopa, mivel az oszlophoz érvényes adattípus van megadva. Ha új oszlopokat szeretne hozzáadni egy leképezéshez, használja az .alter ingestion mapping parancsot.
• Az adatok kötegelése betöltési tulajdonságok használatával történik. Minél több különböző betöltési leképezési tulajdonságot használ, például különböző ConstValue értékeket, annál töredezettebbé válik a betöltés, ami teljesítménycsökkenéshez vezethet.

Példák

[
  {"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"}}
]

A fenti leképezés JSON-sztringként van szerializálva, ha az a .ingest felügyeleti parancs részeként van megadva.

.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"}}
        ]
        ```
    )

Előre létrehozott leképezés

A leképezés előre létrehozott létrehozásakor hivatkozzon a leképezésre név szerint a .ingest felügyeleti parancsban.

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

Identitásleképezés

CsV-leképezés használata a betöltés során leképezési séma definiálása nélkül (lásd : identitásleképezés).

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