Del via

AzCopy

AzCopy er et effektivt kommandolinjeværktøj, der er designet til at lette overførslen af data mellem Azure Storage-konti. Da Microsoft OneLake understøtter de samme API'er, SDK'er og værktøjer som Azure Storage, kan du også bruge AzCopy til at indlæse data til og fra OneLake. Denne artikel hjælper dig med at bruge AzCopy med OneLake fra kopiering af data mellem artefakter til overførsel eller download af data.

Hvorfor bruge AzCopy og OneLake?

AzCopy er optimeret til dataplanhandlinger i stor skala og dataflytning i stor skala. Når du kopierer data mellem lagerkonti (herunder OneLake), flyttes data direkte fra lagerserveren til lagerserveren, så flaskehalse i ydeevnen minimeres. AzCopy er også nem at bruge og pålidelig med indbyggede mekanismer til at håndtere netværksafbrydelser og nye forsøg. Med AzCopy er det nemt at uploade data til OneLake eller indlæse data fra eksisterende kilder direkte i dine elementer i Fabric!

Adgang til arbejdsområde, der er tillid til, og AzCopy

Adgang til arbejdsområder, der er tillid til, giver dig sikker adgang til firewallaktiverede Azure Storage-konti ved at konfigurere en regel for ressourceforekomster på en Azure Storage-konto. Denne regel giver dit specifikke Fabric-arbejdsområde adgang til lagerkontoens firewall fra udvalgte Fabric-oplevelser, f.eks. genveje, pipelines og AzCopy. Ved at konfigurere adgang til arbejdsområder, der er tillid til, kan AzCopy kopiere data fra en firewallaktiveret Azure Storage-konto til OneLake uden at påvirke firewallbeskyttelsen. Få mere at vide om adgang til arbejdsområder, der er tillid til.

Introduktion

Hvis du ikke kender AzCopy, kan du få mere at vide om, hvordan du downloader og kommer i gang med AzCopy på Kom i gang med AzCopy.

Når du bruger AzCopy med OneLake, er der et par vigtige punkter, du skal huske:

  1. Tilføj "fabric.microsoft.com" som et domæne, der er tillid til, ved hjælp af parameteren --trusted-microsoft-suffiks.
  2. Vælg abonnementet på din Azure Storage-kildekonto, når du logger på med dit Microsoft Entra-id, da OneLake kun er interesseret i lejeren.
  3. Brug dobbelte anførselstegn, når du bruger AzCopy i kommandoprompten, og enkelte anførselstegn i PowerShell.

Eksemplerne i denne artikel forudsætter også, at dit Microsoft Entra-id har de nødvendige tilladelser til at få adgang til både kilden og destinationerne.

Endelig skal du bruge mindst én kilde og destination til din dataflytning – eksemplerne på denne side bruger to Fabric lakehouses og én ADLS-konto.

Eksempel: Kopiering af data mellem Fabric-arbejdsområder

Use this sample to copy a file from a lakehouse in one workspace to a different workspace by using the azcopy copy command. Husk først at godkende ved at køre azcopy login først.

Syntax


azcopy copy "https://onelake.dfs.fabric.microsoft.com/<source-workspace-name>/<source-item-name>/Files/<source-file-path>" "https://onelake.dfs.fabric.microsoft.com/<destination-workspace-name>/<destination-item-name>/Files/<destination-file-path>" --trusted-microsoft-suffixes "fabric.microsoft.com"

Kopieringshandlingen er synkron, så når kommandoen returnerer, kopieres alle filer.

Eksempel: Kopiering af data fra ADLS til OneLake med en SAS (Shared Access Signatures)

En SAS (Shared Access Signature) giver kortsigtet, delegeret adgang til Azure Storage og OneLake og er en fantastisk mulighed for at give værktøjer eller brugere midlertidig adgang til lagerplads til engangsupload eller downloads. En SAS er også en god mulighed, hvis Azure Storage-kontoen er i en anden lejer end din OneLake, da Entra-godkendelse ikke fungerer, hvis lejerne er forskellige.

I dette eksempel bruges et entydigt SAS-token til godkendelse til både Azure Storage og OneLake. Du kan få mere at vide om, hvordan du genererer og bruger SAS-tokens med Azure Storage og OneLake, på følgende sider:

Note

Når du bruger et SAS-token til godkendelse til OneLake i AzCopy, skal du angive parameteren '''-s2s-preserve-access-tier' til false.


azcopy copy "https://<account-name>.blob.core.windows.net/<source-container-name>/<source-file-path>?<blob-sas-token>" "https://onelake.dfs.fabric.microsoft.com/<destination-workspace-name>/<destination-item-name>/Files/<destination-file-path>?<onelake-sas-token>" --trusted-microsoft-suffixes "fabric.microsoft.com" --s2s-preserve-access-tier=false

Limitations

Da OneLake er en administreret datasø, understøttes nogle handlinger ikke med AzCopy. Du kan f.eks. ikke bruge AzCopy til at flytte eller kopiere hele elementer eller arbejdsområder. Opret i stedet det nye element på destinationsstedet ved hjælp af en Fabric-oplevelse (f.eks. portalen), og brug derefter AzCopy til at flytte indholdet af det eksisterende element til det nye element.

Related content