Konfigurer Azure Blob Storage i en kopiaktivitet

I denne artikel beskrives det, hvordan du bruger kopiaktiviteten i en datapipeline til at kopiere data fra og til Azure Blob Storage.

Understøttet format

Azure Blob Storage understøtter følgende filformater. Se hver artikel for at få formatbaserede indstillinger.

Understøttet konfiguration

Hvis du vil konfigurere hver fane under kopiaktivitet, skal du gå til henholdsvis følgende afsnit.

Generelt

Se vejledningen til generelle indstillinger for at konfigurere fanen Generelle indstillinger.

Kilde

Følgende egenskaber understøttes for Azure Blob Storage under fanen Kilde i en kopiaktivitet.

Screenshot showing the source tab and the list of properties.

Følgende egenskaber er påkrævet:

  • Datalagertype: Vælg ekstern.
  • Forbind ion: Vælg en Azure Blob Storage-forbindelse på forbindelseslisten. Hvis der ikke findes nogen forbindelse, skal du oprette en ny Azure Blob Storage-forbindelse ved at vælge Ny.
  • Filsti: Vælg Gennemse for at vælge den fil, du vil kopiere, eller udfyld stien manuelt.
  • Filindstillinger: Vælg Filindstillinger for at konfigurere filformatet. Du kan finde detaljerede oplysninger i artikler i Understøttet format for at få flere oplysninger om indstillinger for forskellige filformater.

Under Avanceret kan du angive følgende felter:

  • Filtype: Du kan vælge Filsti, Præfiks, Sti til jokertegnfil, Liste over filer som filtype. Konfigurationen af hver indstilling er:

    • Filsti: Hvis du vælger denne type, kan dataene kopieres fra den angivne objektbeholder eller mappe/filsti, der er angivet tidligere.

    • Præfiks: Præfiks for blobnavnet under den angivne objektbeholder, der er konfigureret til at filtrere kilde-blobs. Blobs, hvis navne starter med container/this_prefix , er valgt. Den bruger filteret på servicesiden til bloblager.

      Når du bruger Præfiks og vælger at kopiere til en filbaseret destination med bevarelse af hierarkiet, bevares understien efter det sidste "/" i præfikset. Du har f.eks. en kilde container/folder/subfolder/file.txtog konfigurerer præfikset som folder/sub, hvorefter den bevarede filsti er subfolder/file.txt.

      Screenshot showing prefix file path type.

    • Sti til jokertegnfil: Angiv mappen eller filstien med jokertegn under den angivne blobobjektbeholder for at filtrere kildemapperne eller -filerne.

      Tilladte jokertegn er * (svarer til nul eller flere tegn) og ? (svarer til nul eller enkelttegn). Bruges ^ til at escape, hvis mappenavnet har et jokertegn eller dette escape-tegn. Du kan få flere eksempler ved at gå til Eksempler på mappe- og filfilter.

      Screenshot showing wildcard file path.

      Sti til jokertegnmappe: Angiv mappestien med jokertegn under den angivne objektbeholder for at filtrere kildemapper.

      Filnavn med jokertegn: Angiv filnavnet med jokertegn under den angivne objektbeholder og mappesti (eller sti til jokertegnmappen) for at filtrere kildefiler.

    • Liste over filer: Angiver en given fil, der skal kopieres til. På listen Sti til fil skal du angive eller gå til en tekstfil, der indeholder en liste over filer, du vil kopiere, én fil pr. linje, som er den relative sti til hver fil.

      Når du bruger denne indstilling, skal du ikke angive et filnavn. Du kan få flere eksempler ved at gå til Eksempler på fillister.

      Screenshot showing path to file list.

  • Rekursivt: Hvis dette afkrydsningsfelt er markeret, behandles alle filer i inputmappen og dens undermapper rekursivt. Hvis du fjerner markeringen i afkrydsningsfeltet, behandles kun dem i den valgte mappe. Denne indstilling er deaktiveret, når der vælges en enkelt fil.

  • Slet filer efter fuldførelse: Hvis dette afkrydsningsfelt er markeret, slettes de binære filer fra kildelageret, når de er flyttet til destinationslageret. Filsletningen sker pr. fil, så når kopieringsaktiviteten mislykkes, kan du se, at nogle filer allerede er blevet kopieret til destinationen og slettet fra kilden, mens andre stadig er i kildelageret.

    Bemærk

    Denne egenskab er kun gyldig i et kopieringsscenarie for binære filer.

  • Maks. antal samtidige forbindelser: Denne egenskab angiver den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser.

Destination

Følgende egenskaber understøttes for Azure Blob Storage under fanen Destination for en kopiaktivitet.

Screenshot showing destination tab.

Følgende egenskaber er påkrævet:

  • Datalagertype: Vælg ekstern.
  • Forbind ion: Vælg en Azure Blob Storage-forbindelse på forbindelseslisten. Hvis forbindelsen ikke findes, skal du oprette en ny Azure Blob Storage-forbindelse ved at vælge Ny.
  • Filsti: Vælg Gennemse for at vælge den fil, du vil kopiere eller udfylde stien manuelt.
  • Filindstillinger: Vælg Filindstillinger for at konfigurere filformatet. Du kan finde detaljerede oplysninger i artikler i Understøttet format for at få flere oplysninger om indstillinger for forskellige filformater.

Under Avanceret kan du angive følgende felter:

  • Funktionsmåde for kopiering: Definerer kopifunktionsmåden, når kilden er filer fra et filbaseret datalager. Du kan vælge Tilføj dynamisk indhold, Ingen, Flad hierarki eller Bevar hierarki på rullelisten.

    • Tilføj dynamisk indhold: Hvis du vil angive et udtryk for en egenskabsværdi, skal du vælge Tilføj dynamisk indhold. Dette valg åbner udtryksgeneratoren, hvor du kan oprette udtryk fra understøttede systemvariabler, aktivitetsoutput, funktioner og brugerdefinerede variabler eller parametre. Du kan få oplysninger om udtrykssproget ved at gå til Udtryk og funktioner.

    • Ingen: Vælg dette valg for ikke at bruge kopiering.

    • Fladgør hierarki: Alle filer fra kildemappen er på det første niveau i destinationsmappen. Destinationsfilerne har automatisk genererede navne.

    • Bevar hierarki: Bevarer filhierarkiet i destinationsmappen. Den relative sti for kildefilen til kildemappen er identisk med den relative sti for destinationsfilen til destinationsmappen.

      Screenshot showing copy behavior.

  • Maksimalt antal samtidige forbindelser: Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser.

  • Blokstørrelse (MB): Angiv blokstørrelsen i megabyte, der bruges til at skrive data til at blokere blobs. Du kan få flere oplysninger ved at gå til Om blok-blobs.

  • Metadata: Angiv brugerdefinerede metadata, når der kopieres til en destination. Hvert objekt under matrixen metadata repræsenterer en ekstra kolonne. name definerer navnet på metadatanøglen og value angiver dataværdien for den pågældende nøgle. Hvis funktionen til bevarelse afattributter bruges, vil de angivne metadata blive forenings-/overskrive med kildefilens metadata.

    Tilladte dataværdier er:

    • $$LASTMODIFIED: en reserveret variabel angiver, at kildefilerne senest blev ændret. Anvend kun på filbaseret kilde med binært format.

    • Expression

    • Statisk værdi

      Screenshot showing metadata.

Tilknytning

For Konfiguration af fanen Tilknytning skal du gå til Konfigurer dine tilknytninger under fanen Tilknytning. Hvis du vælger Binær som filformat, understøttes tilknytning ikke.

Indstillinger

Hvis du vil have Indstillinger fanekonfiguration, skal du se Konfigurer dine andre indstillinger under fanen Indstillinger.

Tabeloversigt

Følgende tabeller indeholder flere oplysninger om kopiaktiviteten i Azure Blob Storage.

Kildeoplysninger

Navn Beskrivelse Værdi Obligatorisk JSON-scriptegenskab
Datalagertype Datalagertypen. Eksternt Ja /
Forbind ion Din forbindelse til kildedatalageret. <din forbindelse> Ja Forbindelse
Filsti Filstien til kildedataene. <filstien til kilden> Ja Container
Filnavn
Filtype Den filtype, du vil bruge. • Filsti
•Præfiks
• Sti til jokertegnmappe, navn på jokertegnfil
• Liste over filer
Nr.
•Præfiks
• jokertegnFolderPath, jokertegnFileName
• fileListPath
Rekursivt Behandl alle filer i inputmappen og dens undermapper rekursivt eller kun dem i den valgte mappe. Denne indstilling er deaktiveret, når der vælges en enkelt fil. Markeret eller fravælg Nr. Rekursive
Slet filer efter fuldførelse Filerne i kildedatalageret slettes lige efter, at de er flyttet til destinationslageret. Filsletningen sker pr. fil, så når en kopiaktivitet mislykkes, kan du se, at nogle filer allerede er blevet kopieret til destinationen og slettet fra kilden, mens andre stadig er i kildelageret. Markeret eller fravælg Nr. deleteFilesAfterCompletion
Maks. antal samtidige forbindelser Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser. <maks. antal samtidige forbindelser> Nr. maxConcurrent Forbind ions

Destinationsoplysninger

Navn Beskrivelse Værdi Obligatorisk JSON-scriptegenskab
Datalagertype Datalagertypen. Eksternt Ja /
Forbind ion Din forbindelse til destinationsdatalageret. <din forbindelse> Ja Forbindelse
Filsti Filstien til dine destinationsdata. Filstien til kilden Ja Container
Filnavn
Funktionsmåde for kopiering Definerer funktionsmåden ved kopiering af filer fra ét filsystem, f.eks. lager, til det andet (f.eks. fra ét bloblager til et andet). •Ingen
• Tilføj dynamisk indhold
• Fladgør hierarki
• Bevar hierarki
Nr. copyBehavior
Maks. antal samtidige forbindelser Den øvre grænse for samtidige forbindelser, der er oprettet til datalageret under aktivitetskørslen. Angiv kun en værdi, når du vil begrænse samtidige forbindelser. <maks. antal samtidige forbindelser> Nr. maxConcurrent Forbind ions
Blokstørrelse (MB) Angiv blokstørrelsen i MB, når du skriver data til Azure Blob Storage. Den tilladte værdi er mellem 4 MB og 100 MB. <blokstørrelse> Nr. blockSizeInMB
Metadata Angiv de brugerdefinerede metadata, når de kopieres til destinationen. $$LASTMODIFIED
•Udtryk
• Statisk værdi
Nr. Metadata