Azure Synapse Data Explorer eigenschappen van gegevensopname (preview)

Gegevensopname is het proces waarmee gegevens worden toegevoegd aan een tabel en beschikbaar worden gesteld voor query's in Data Explorer. U voegt eigenschappen toe aan de opdracht opname na het with trefwoord.

Opname-eigenschappen

De volgende tabel bevat de eigenschappen die worden ondersteund door Data Explorer, beschrijft deze en bevat voorbeelden:

Eigenschap Beschrijving Voorbeeld
ingestionMapping Een tekenreekswaarde die aangeeft hoe gegevens uit het bronbestand worden toegewezen aan de werkelijke kolommen in de tabel. Definieer de format waarde met het relevante toewijzingstype. Zie gegevenstoewijzingen. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(afgeschaft: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Een tekenreekswaarde die aangeeft hoe u gegevens uit het bronbestand toewijst aan de werkelijke kolommen in de tabel met behulp van een benoemd toewijzingsbeleidsobject. Definieer de format waarde met het relevante toewijzingstype. Zie gegevenstoewijzingen. with (format="csv", ingestionMappingReference = "Mapping1")
(afgeschaft: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime De datum/tijd-waarde (opgemaakt als een ISO8601-tekenreeks) die moet worden gebruikt tijdens het maken van de opgenomen gegevensbereiken. Indien niet opgegeven, wordt de huidige waarde (now()) gebruikt. Het overschrijven van de standaardwaarde is handig bij het opnemen van oudere gegevens, zodat het bewaarbeleid correct wordt toegepast. Zorg ervoor dat de eigenschap in het Lookbacksamenvoegbeleid van de doeltabel is afgestemd op de opgegeven waarde wanneer deze is opgegeven. with (creationTime="2017-02-13")
extend_schema Een Booleaanse waarde die, indien opgegeven, de opdracht instrueert om het schema van de tabel uit te breiden (standaard ingesteld op false). Deze optie is alleen van toepassing op .append en .set-or-append opdrachten. De enige toegestane schema-extensies hebben extra kolommen toegevoegd aan de tabel aan het einde. Als het oorspronkelijke tabelschema is (a:string, b:int), zou een geldige schema-extensie zijn (a:string, b:int, c:datetime, d:string), maar (a:string, c:datetime) niet geldig zijn
folder Voor opdrachten voor opnemen van query's , de map die moet worden toegewezen aan de tabel. Als de tabel al bestaat, overschrijft deze eigenschap de map van de tabel. with (folder="Tables/Temporary")
format De gegevensindeling (zie ondersteunde gegevensindelingen). with (format="csv")
ingestIfNotExists Een tekenreekswaarde die, indien opgegeven, voorkomt dat opname slaagt als de tabel al gegevens bevat met een ingest-by: tag met dezelfde waarde. Dit zorgt voor idempotente gegevensopname. Zie opnemen op: tags voor meer informatie. De eigenschappen with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') geven aan dat als er al gegevens met de tag ingest-by:Part0001 bestaan, de huidige opname niet voltooien. Als deze nog niet bestaat, moet deze nieuwe opname deze tagset hebben (voor het geval een toekomstige opname probeert dezelfde gegevens opnieuw op te nemen.)
ignoreFirstRecord Een Booleaanse waarde die, indien ingesteld op true, aangeeft dat opname de eerste record van elk bestand moet negeren. Deze eigenschap is handig voor bestanden in CSVen vergelijkbare indelingen, als de eerste record in het bestand de kolomnamen zijn. false Standaard wordt ervan uitgegaan. with (ignoreFirstRecord=false)
persistDetails Een Booleaanse waarde die, indien opgegeven, aangeeft dat de opdracht de gedetailleerde resultaten moet behouden (zelfs als dit lukt) zodat de opdracht .show operation details kan ophalen. Wordt standaard ingesteld op false. with (persistDetails=true)
policy_ingestiontime Een Booleaanse waarde die, indien opgegeven, beschrijft of het opnametijdbeleid moet worden ingeschakeld voor een tabel die met deze opdracht wordt gemaakt. De standaardwaarde is true. with (policy_ingestiontime=false)
recreate_schema Een Booleaanse waarde die, indien opgegeven, beschrijft of de opdracht het schema van de tabel opnieuw kan maken. Deze eigenschap is alleen van toepassing op de .set-or-replace opdracht. Deze eigenschap heeft voorrang op de extend_schema eigenschap als beide zijn ingesteld. with (recreate_schema=true)
tags Een lijst met tags die moeten worden gekoppeld aan de opgenomen gegevens, opgemaakt als een JSON-tekenreeks with (tags="['Tag1', 'Tag2']")
validationPolicy Een JSON-tekenreeks die aangeeft welke validaties moeten worden uitgevoerd tijdens opname. Zie Gegevensopname voor een uitleg van de verschillende opties. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (dit is eigenlijk het standaardbeleid)
zipPattern Gebruik deze eigenschap bij het opnemen van gegevens uit de opslag met een ZIP-archief. Dit is een tekenreekswaarde die de reguliere expressie aangeeft die moet worden gebruikt bij het selecteren van welke bestanden in het ZIP-archief u wilt opnemen. Alle andere bestanden in het archief worden genegeerd. with (zipPattern="*.csv")

Volgende stappen