Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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
-
synckan inte synkronisera filändringar från en mapp på en fjärransluten Azure Databricks-arbetsyta tillbaka till en katalog på den lokala utvecklingsdatorn. -
synckan 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
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