Gegevens ophalen uit Azure Storage
Gegevensopname is het proces dat wordt gebruikt voor het laden van gegevens uit een of meer bronnen in een tabel in Azure Data Explorer. Zodra de gegevens zijn opgenomen, zijn de gegevens beschikbaar voor query's. In dit artikel leert u hoe u gegevens opvragen uit Azure Storage (ADLS Gen2-container, blobcontainer of afzonderlijke blobs) in een nieuwe of bestaande tabel.
Opname vanuit een Azure-opslagaccount is een eenmalige bewerking. Zie Streaming ingave configurerenom gegevens continu op te nemen.
Zie Overzicht van gegevensopname in Azure Data Explorervoor algemene informatie over gegevensopname.
Voorwaarden
- Een Microsoft-account of een Microsoft Entra-gebruikersidentiteit. Er is geen Azure-abonnement vereist.
- Meld u aan bij de webgebruikersinterface van Azure Data Explorer.
- Een Azure Data Explorer-cluster en -database. Een cluster en database maken.
- Een -opslagaccount.
Gegevens ophalen
Kies in het linkermenu Query.
Klik met de rechtermuisknop op de database waar u de gegevens wilt opnemen. Selecteer Gegevens ophalen.
Bron
In het venster Gegevens ophalen is het tabblad Bron geselecteerd.
Selecteer de gegevensbron in de beschikbare lijst. In dit voorbeeld neemt u gegevens op uit Azure Storage-.
Configureren
Selecteer een doeldatabase en -tabel. Als u gegevens wilt opnemen in een nieuwe tabel, selecteert u + Nieuwe tabel en voert u een tabelnaam in.
Notitie
Tabelnamen kunnen maximaal 1024 tekens zijn, waaronder spaties, alfanumerieke, afbreekstreepjes en onderstrepingstekens. Speciale tekens worden niet ondersteund.
Als u uw bron wilt toevoegen, selecteer dan Container selecteren of URI toevoegen.
Als u Container selecterenhebt geselecteerd, vult u de volgende velden in:
instellen Veldbeschrijving Abonnement De abonnements-id waar het opslagaccount zich bevindt. Opslagaccount De naam die uw opslagaccount identificeert. Container De opslagcontainer die u wilt importeren. bestandsfilters (optioneel) Maplocatie Hiermee filtert u gegevens om bestanden met een specifiek mappad te verwerken. Bestandsextensie Hiermee filtert u gegevens om alleen bestanden op te nemen met een specifieke bestandsextensie. Als u URI-toevoegen hebt geselecteerd, genereert u vanuit het opslagaccount een SAS-URL voor de container of afzonderlijke blobs die u wilt opnemen. Stel de rechten in op lezen en weergeven voor containers of lezen voor afzonderlijke blobs. Zie Een SAS-token genererenvoor meer informatie.
- Plak de URL in het veld URI en selecteer vervolgens het plusteken (+). U kunt meerdere URI's toevoegen voor afzonderlijke blobs of één URI voor een container.
Notitie
- U kunt maximaal 10 afzonderlijke blobs toevoegen. Elke blob kan maximaal 1 GB ongecomprimeerd zijn.
- U kunt maximaal 5000 blobs opnemen vanuit één container.
- U kunt geen afzonderlijke blobs en containers gelijktijdig innemen.
Kies Volgende
Inspecteren
Het tabblad Controleren wordt geopend met een voorbeeld van de gegevens.
Als u het opnameproces wilt voltooien, selecteert u voltooien.
Optioneel:
- Selecteer opdrachtviewer om de automatische opdrachten weer te geven en te kopiëren die zijn gegenereerd op basis van uw invoer.
- Gebruik het schemadefinitiebestand vervolgkeuzelijst om het bestand te wijzigen waaruit het schema is afgeleid.
- Wijzig de automatisch uitgestelde gegevensindeling door de gewenste indeling in de vervolgkeuzelijst te selecteren. Zie Gegevensindelingen die worden ondersteund door Azure Data Explorer voor ingestie.
- Kolommen bewerken.
- Verken geavanceerde opties op basis van gegevenstype.
Kolommen bewerken
Notitie
- Voor tabelindelingen (CSV, TSV, PSV) kunt u een kolom niet twee keer mappen. Om aan een bestaande kolom toe te wijzen, verwijder eerst de nieuwe kolom.
- U kunt een bestaand kolomtype niet wijzigen. Als u probeert toe te wijzen aan een kolom met een andere indeling, kunt u uiteindelijk lege kolommen krijgen.
De wijzigingen die u in een tabel kunt aanbrengen, zijn afhankelijk van de volgende parameters:
- tabeltype is nieuw of bestaand
- Mappingtype is nieuw of bestaand
Tabeltype | Toewijzingstype | Beschikbare aanpassingen |
---|---|---|
Nieuwe tabel | Nieuwe mapping | Naam van kolom wijzigen, gegevenstype wijzigen, gegevensbron wijzigen, toewijzingstransformatie, kolom toevoegen, kolom verwijderen |
Bestaande tabel | Nieuwe koppeling | Kolom toevoegen (waarop u vervolgens het gegevenstype, de naam kunt wijzigen en bijwerken) |
Bestaande tabel | Bestaande toewijzing | geen |
Toewijzingstransformaties
Sommige toewijzingen van gegevensindelingen (Parquet, JSON en Avro) bieden ondersteuning voor eenvoudige transformaties tijdens het innameproces. Om toewijzingstransformaties toe te passen, maakt of wijzigt u een kolom in het venster Kolommen bewerken.
Toewijzingstransformaties kunnen worden uitgevoerd op een kolom van het type tekst of datum en tijd, waarbij de bron het gegevenstype int of long heeft. Ondersteunde toewijzingstransformaties zijn:
- DatumTijdVanUnixSeconden
- DateTimeFromUnixMilliseconds
- DateTimeFromUnixMicroseconds
- DateTimeFromUnixNanoseconds
Geavanceerde opties op basis van gegevenstype
Tabellaire(CSV, TSV, PSV) :
Als u tabelindelingen opneemt in een bestaande tabel, kunt u Geavanceerd>Huidig tabelschema behoudenselecteren. Tabelgegevens bevatten niet noodzakelijkerwijs de kolomnamen die worden gebruikt om brongegevens toe te wijzen aan de bestaande kolommen. Wanneer deze optie is ingeschakeld, wordt de toewijzing in volgorde uitgevoerd en blijft het tabelschema onveranderd. Als deze optie is uitgeschakeld, worden nieuwe kolommen gemaakt voor binnenkomende gegevens, ongeacht de gegevensstructuur.
Als u de eerste rij als kolomnamen wilt gebruiken, selecteert u Advanced>Eerste rij is kolomkop.
JSON:
Als u de kolomverdeling van JSON-gegevens wilt bepalen, selecteert u Advanced>Geneste niveaus, van 1 tot en met 100.
Als u Geavanceerde>Fouten in gegevensindeling negerenselecteert, worden de gegevens opgenomen in JSON-indeling. Als u dit selectievakje uitgeschakeld laat, worden de gegevens opgenomen in multijson-indeling.
Samenvatting
In het venster Gegevensvoorbereiding worden alle drie de stappen gemarkeerd met groene vinkjes wanneer de gegevensopname is voltooid. U kunt de opdrachten bekijken die voor elke stap zijn gebruikt, of een kaart selecteren om de opgenomen gegevens op te vragen, visualiseren of verwijderen.