Delen via

Quickstart: Bulksgewijs laden met Synapse Studio

  • Artikel

U kunt eenvoudig gegevens laden met de wizard Bulksgewijs laden van Synapse Studio. Synapse Studio is een functie van Azure Synapse Analytics. In de wizard Bulksgewijs laden maakt u een T-SQL-script met de COPY-instructie om gegevens bulksgewijs te laden in een toegewezen SQL-pool.

Invoerpunten voor de wizard Bulksgewijs laden

U kunt gegevens bulksgewijs laden door met de rechtermuisknop op het volgende gebied in Synapse Studio te klikken: een bestand of map van een Azure-opslagaccount dat is gekoppeld aan uw werkruimte.

Screenshot that shows right-clicking a file or folder from a storage account.

Vereisten

  • De wizard genereert een COPY-instructie, die gebruikmaakt van Pass-Through van Microsoft Entra voor verificatie. Uw Microsoft Entra-gebruiker moet toegang hebben tot de werkruimte met ten minste de Azure-rol Inzender voor opslagblobgegevens voor het Azure Data Lake Storage Gen2-account.

  • U moet beschikken over de vereiste machtigingen om de COPY-instructie te gebruiken en ook over machtigingen om een tabel te maken (Create Table), als u gegevens in een nieuwe tabel wilt laden.

  • De service die aan het Azure Data Lake Storage Gen2-account is gekoppeld, moet toegang hebben tot het bestand of de map die moet worden geladen. Als de verificatiemethode voor de gekoppelde service bijvoorbeeld een beheerde identiteit is, moet de beheerde identiteit voor de werkruimte ten minste over de machtiging Storage Blob Data Reader beschikken voor het opslagaccount.

  • Als een virtueel netwerk is ingeschakeld voor uw werkruimte, controleert u of interactieve creatie is ingeschakeld voor de geïntegreerde runtime van de gekoppelde services van het Data Lake Storage Gen2-account voor de locatie van de brongegevens en foutbestanden. Interactieve creatie is vereist om schema's automatisch te detecteren, previews van de inhoud van het bronbestand te bekijken en door Data Lake Storage Gen2-opslagaccounts in de wizard te bladeren.

Stappen

  1. Selecteer het opslagaccount en het bestand of de map waar vanuit u gegevens wilt laden in het deelvenster Opslaglocatie van bron. Met de wizard wordt automatisch geprobeerd om Parquet-bestanden en CSV-bestanden (tekstbestanden met scheidingstekens) te detecteren, waaronder het toewijzen van de bronvelden uit het bestand aan de juiste SQL-doelgegevenstypen.

    Screenshot that shows selecting a source location.

  2. Selecteer de instellingen voor de bestandsindeling, inclusief de foutinstellingen voor wanneer er rijen zijn geweigerd tijdens het bulksgewijs laden. U kunt ook Voorbeeld van gegevens weergeven selecteren om te zien hoe het bestand wordt geparseerd met de COPY-instructie. Configureer op basis hiervan de instellingen voor bestandsindeling. Telkens wanneer u een instelling voor de bestandsindeling wijzigt, selecteert u Voorbeeld van gegevens weergeven om te zien hoe met de COPY-instructie het bestand wordt geparseerd met de bijgewerkte instelling.

    Screenshot that shows previewing data.

    Notitie

    • De wizard Bulksgewijs laden biedt geen ondersteuning voor het bekijken van een voorbeeld van de gegevens met veldeindtekens met meerdere tekens. De wizard geeft een voorbeeld van de gegevens in één kolom weer wanneer een veldeindteken met meerdere tekens wordt opgegeven.
    • Wanneer u Kolomnamen afleiden selecteert, worden met de wizard Bulksgewijs laden de kolomnamen geparseerd uit de eerste rij, opgegeven in het veld Eerste rij. Met de wizard Bulksgewijs laden wordt de waarde FIRSTROW in de COPY-instructie automatisch met 1 verhoogd om deze koprij te negeren.
    • Het opgeven van rij-afsluitingen met meerdere tekens wordt ondersteund in de COPY-instructie. De wizard Bulksgewijs laden ondersteunt dit echter niet en er wordt een fout gegenereerd.

  3. Selecteer de toegewezen SQL-pool die u gebruikt om gegevens te laden, en geef aan of de gegevens naar een bestaande of nieuwe tabel moeten worden geladen. Screenshot that shows selecting a target location.

  4. Selecteer Kolomtoewijzing configureren om te controleren of u de juiste kolomtoewijzing gebruikt. De namen van kolommen worden automatisch gedetecteerd als Kolomnamen afleiden is ingeschakeld. Bij nieuwe tabellen is het van cruciaal belang dat u de kolomtoewijzing configureert om de gegevenstypen van de doelkolom bij te werken.

    Screenshot that shows configuring column mapping.

  5. Selecteer Script openen. Er wordt een T-SQL-script gegenereerd met de COPY-instructie om gegevens uit uw data lake te laden. Screenshot that shows opening the SQL script.

Volgende stappen

  • Raadpleeg het artikel over de COPY-instructie voor meer informatie over de mogelijkheden van COPY.
  • Controleer het artikel Overzicht gegevens laden artikel voor meer informatie over het gebruik van een proces voor uitpakken, transformeren en laden (ETL).