Del via

AzCopy

AzCopy er et kraftig kommandolinjeverktøy som er utformet for å forenkle overføring av data mellom Azure Storage-kontoer. Siden Microsoft OneLake støtter de samme API-ene, SDK-ene og verktøyene som Azure Storage, kan du også bruke AzCopy til å laste inn data til og fra OneLake. Denne artikkelen hjelper deg med å bruke AzCopy med OneLake, fra kopiering av data mellom artefakter til opplasting eller nedlasting av data.

Hvorfor bruke AzCopy og OneLake?

AzCopy er optimalisert for dataplanoperasjoner i stor skala og databevegelse i stor skala. Når du kopierer data mellom lagringskontoer (inkludert OneLake), flyttes data direkte fra lagringsserver til lagringsserver, noe som minimerer flaskehalser for ytelse. AzCopy er også brukervennlig og pålitelig, med innebygde mekanismer for å håndtere nettverksavbrudd og nye forsøk. Med AzCopy er det enkelt å laste opp data til OneLake, eller laste inn data fra eksisterende kilder direkte i elementene i Fabric!

Tilgang til klarert arbeidsområde og AzCopy

Med klarert arbeidsområdetilgang får du tilgang til brannmuraktiverte Azure Storage-kontoer på en sikker måte ved å konfigurere en ressursforekomstregel på en Azure Storage-konto. Denne regelen lar det bestemte Fabric-arbeidsområdet få tilgang til brannmuren for lagringskontoen fra utvalgte Fabric-opplevelser, for eksempel snarveier, datasamlebånd og AzCopy. Ved å konfigurere klarert tilgang til arbeidsområdet kan AzCopy kopiere data fra en brannmuraktivert Azure Storage-konto til OneLake uten å påvirke brannmurbeskyttelsen. Finn ut mer om klarert arbeidsområdetilgang.

Komme i gang

Hvis du ikke har brukt AzCopy før, kan du lære hvordan du laster ned og kommer i gang med AzCopy på Kom i gang med AzCopy.

Når du bruker AzCopy med OneLake, er det noen viktige punkter å huske:

  1. Legg til «fabric.microsoft.com» som et klarert domene ved hjelp av parameteren klarerte microsoft-suffikser.
  2. Velg abonnementet på Azure Storage-kildekontoen når du logger på med Microsoft Entra-ID-en, siden OneLake bare bryr seg om leieren.
  3. Bruk doble anførselstegn når du bruker AzCopy i ledeteksten, og enkle anførselstegn i PowerShell.

Eksemplene i denne artikkelen forutsetter også at Microsoft Entra-ID-en har riktige tillatelser til å få tilgang til både kilden og mål.

Til slutt trenger du minst én kilde og destinasjon for databevegelsen – eksemplene på denne siden bruker to Fabric Lakehouses og én ADLS-konto.

Eksempel: Kopiere data mellom Fabric-arbeidsområ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 å godkjenne først ved å kjø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"

Kopieringsoperasjonen er synkron, så når kommandoen returneres, kopieres alle filene.

Eksempel: Kopiere data fra ADLS til OneLake med delte tilgangssignaturer (SAS)

En delt tilgangssignatur (SAS) gir kortsiktig, delegert tilgang til Azure Storage og OneLake, og er et flott alternativ for å gi verktøy eller brukere midlertidig tilgang til lagring for engangsopplasting eller nedlastinger. En SAS er også et flott alternativ hvis Azure Storage-kontoen er i en annen leier enn OneLake, da Entra-autorisasjon ikke vil fungere hvis tenantene er forskjellige.

Dette eksemplet bruker et unikt SAS-token til å godkjenne til både Azure Storage og OneLake. Hvis du vil lære mer om generering og bruk av SAS-tokener med Azure Storage og OneLake, kan du se følgende sider:

Note

Når du bruker et SAS-token til å godkjenne til OneLake i AzCopy, må du angi parameteren «''-s2s-preserve-access-tier' til usann.


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

Siden OneLake er en administrert datainnsjø, støttes ikke noen operasjoner med AzCopy. Du kan for eksempel ikke bruke AzCopy til å flytte eller kopiere hele elementer eller arbeidsområder. Opprett i stedet det nye elementet på målplasseringen ved hjelp av en stoffopplevelse (for eksempel portalen), og bruk deretter AzCopy til å flytte innholdet i det eksisterende elementet til det nye elementet.

Related content