Dela via


sync kommando

Note

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. The Databricks CLI is in Public Preview.

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

The sync command group within the Databricks CLI enables one-way synchronization of local code and file changes in a directory on your local development machine to a folder in your remote Azure Databricks workspace.

Note

  • sync kan inte synkronisera filändringar från en mapp på en fjärransluten Azure Databricks-arbetsyta tillbaka till en katalog på den lokala utvecklingsdatorn.
  • sync kan synkronisera filändringar från en lokal utvecklingsdator endast till arbetsyteanvändarfiler (/Users) i din Azure Databricks-arbetsyta. It cannot synchronize to DBFS (dbfs:/) files. To synchronize file changes from a local development machine to DBFS (dbfs:/) in your Azure Databricks workspace, use the dbx sync utility.

databricks sync

Synkronisera en lokal katalog till en arbetsytekatalog.

databricks sync [flags] SRC DST

Arguments

SRC

    Sökvägen till källkatalogen

DST

    Sökvägen till målkatalogen

Options

--dry-run

    Simulera synkroniseringskörning utan att göra faktiska ändringar

--exclude strings

    Mönster som ska undantas från synkronisering (kan anges flera gånger)

--exclude-from string

    Fil som innehåller mönster som ska undantas från synkronisering (ett mönster per rad)

--full

    Utföra fullständig synkronisering (standardvärdet är inkrementellt)

--include strings

    Mönster som ska inkluderas i synkronisering (kan anges flera gånger)

--include-from string

    Fil som innehåller mönster som ska inkluderas för synkronisering (ett mönster per rad)

--interval duration

    Avsökningsintervall för filsystem (för --watch) (standard 1s)

--watch

    Titta efter ändringar i det lokala filsystemet

Global flags

Examples

Följande avsnitt visar hur du sync använder kommandot.

Synkronisera lokala filändringar stegvis till en fjärrkatalog

Kör kommandot så här för att utföra en enda, inkrementell enkelriktad synkronisering av filändringar i en lokal katalog till en mapp på en fjärransluten sync Azure Databricks-arbetsyta:

databricks sync <local-directory-path> <remote-directory-path>

Om du till exempel vill göra en enkelriktad, stegvis synkronisering av alla filändringar i mappen med namnet my-local-folder i den lokala aktuella arbetskatalogen, kör du följande kommando till mappen my-workspace-folder på den fjärranslutna arbetsytan:

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder

I det här exemplet synkroniseras endast filändringar sedan den senaste körningen sync av kommandot till /Users/someone@example.com/my-workspace-folder. Som standard används arbetsytans URL i anroparens profil för att avgöra vilken fjärrarbetsyta som ska synkroniseras till DEFAULT.

Synkronisera endast specifika filer

Om du vill inkludera eller exkludera specifika filer som ska synkroniseras baserat på angivna mönster använder du --includealternativen , --include-from, --excludeeller --exclude-from .

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder --exclude-from .gitignore

Note

Om du vill synkronisera filer i ett paket använder du konfigurationsmappningen sync i stället. See sync.

I följande exempel undantas vissa filmönster från synkronisering:

databricks sync --exclude "*.pyc" --exclude "__pycache__" ./my-local-folder /Users/someone@example.com/my-workspace-folder

Synkronisera lokala filändringar helt till en fjärrkatalog

Om du vill utföra en enda, fullständig enkelriktad synkronisering av filändringar i en lokal katalog till en mapp i en fjärransluten sync Azure Databricks-arbetsyta, oavsett när det senaste --full kommandot kördes, använder du alternativet, till exempel:

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder --full

Synkronisera lokala filändringar kontinuerligt till en fjärrkatalog

Om du vill aktivera kontinuerlig enkelriktad synkronisering av filändringar i en lokal katalog till en mapp i en fjärransluten --watch Azure Databricks-arbetsyta använder du alternativet, till exempel:

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder --watch

Enkelriktad synkronisering fortsätter tills kommandot stoppas från terminalen, vanligtvis genom att trycka på Ctrl + c eller Ctrl + z.

Avsökning för möjliga synkroniseringshändelser sker en gång per sekund som standard. Om du vill ändra det här intervallet använder du --interval alternativet tillsammans med antalet sekunder som ska avsökas följt av tecknet s, till exempel i fem sekunder:

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder --watch --interval 5s

Ändra utdataformatet för synkroniseringsförlopp

Synkroniseringsstatusinformationen matas ut till terminalen i textformat som standard. Om du vill ange utdataformatet för synkroniseringsstatus använder du alternativet --output och anger antingen text (standardvärdet om --output inte har angetts på annat sätt) eller json, till exempel:

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder --output json

Förhandsgranska filåtgärder för en synkronisering

Om du vill förhandsgranska en synkronisering utan att utföra filsynkroniseringsåtgärderna --dry-run använder du alternativet, till exempel:

databricks sync ./my-local-folder /Users/someone@example.com/my-workspace-folder --dry-run
Warn: Running in dry-run mode. No actual changes will be made.
Action: PUT: test.txt
Uploaded test.txt
Initial Sync Complete

Global flags

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format format

    Loggformattypen eller textjson. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i filen som ~/.databrickscfg ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas