Visual Studio Code için Databricks uzantısını kullanarak Databricks projenizi yapılandırma
Visual Studio Code için Databricks uzantısı, databricks projenizin ayarlarını kolayca yapılandırmanıza ve güncelleştirmenize olanak tanıyan bir Yapılandırma görünümü sunar. Bu özellikler arasında hedef çalışma alanı dağıtım seçicisi, kolay kimlik doğrulaması ve işlem yapılandırması, çalışma alanı klasör eşitlemesi ve hata ayıklama için gereken Python sanal ortamını etkinleştirmeye yönelik basit adımlar bulunur.
Visual Studio Code için Databricks uzantısındaki Yapılandırma görünümü, bir projeyi oluşturduktan veya databricks projesine geçirdiğinizde kullanılabilir. Bkz. Yeni Databricks projesi oluşturma.
Not
Visual Studio Code için Databricks uzantısının önceki sürümleri, proje JSON dosyasında tanımlı yapılandırma ayarları ve ortam değişkenleri terminalde ayarlanmıştı. Sürüm sürümünde, proje ve ortam yapılandırması ve databricks.env dosyalarında databricks.yml bulunur.
Projeniz bir Databricks Varlık Paketi ise Databricks uzantı kullanıcı arabirimi, paket kaynaklarınızı ve değişkenlerinizi yönetmek için bir Paket Kaynak Gezgini ve Paket Değişkenleri Görünümü de sağlar. Bkz . Databricks Varlık Paketleri uzantısı özellikleri.
Hedef dağıtım çalışma alanını değiştirme
Databricks projenizin dağıtım hedefini seçmek veya değiştirmek için (örneğin, bir dev hedeften hedefe prod geçmek için):
Databricks uzantı panelinin Yapılandırma görünümünde, Hedefle ilişkilendirilmiş dişli simgesine (Databricks Varlık Paketi hedefi seçin) tıklayın.
Komut Paleti'nde istediğiniz dağıtım hedefini seçin.
Bir hedef yapılandırıldıktan sonra Konak ve dağıtım Modu görüntülenir. Databricks Varlık Paketleri dağıtım modları hakkında bilgi için bkz . Databricks Varlık Paketi dağıtım modları.
Çalışma alanı konağı, projeyle ilişkili yapılandırma dosyasındaki hedef workspace ayarı databricks.yml değiştirilerek değiştirilebilir. Hedefleri görün.
Not
Visual Studio Code özellikleri için aşağıdaki Databricks uzantısı yalnızca hedef dağıtım modu geliştirme aşamasında olduğunda kullanılabilir:
- Paket işleri için ekli geliştirme kümesini kullanma
- Çalışma alanı klasör dosyalarını eşitleme
- Etkileşimli bir geliştirme kümesi seçin
Proje için Databricks profilini yapılandırma
Databricks projesi oluşturduğunuzda veya bir projeyi Databricks projesi olacak şekilde geçirdiğinizde, Databricks'e bağlanmak için kullanılan kimlik doğrulama ayarlarını içeren bir profil yapılandırabilirsiniz. Kullanılan kimlik doğrulama profilini değiştirmek istiyorsanız, Yapılandırma görünümünde AuthType ile ilişkilendirilmiş dişli simgesine tıklayın.
Visual Studio Code kimlik doğrulaması için Databricks uzantısı hakkında daha fazla bilgi için bkz . Visual Studio Code için Databricks uzantısı için kimlik doğrulaması kurulumu.
Kod ve işleri çalıştırmak için küme seçme
Visual Studio Code için Databricks uzantısını kullanarak mevcut bir Azure Databricks kümesini seçebilir veya kodunuzu ve işlerinizi çalıştırmak için yeni bir Azure Databricks kümesi oluşturabilirsiniz. İşlemle bağlantı kurduktan sonra kümenin kimliği, Databricks Runtime sürümü, oluşturucusu, durumu ve erişim modu görüntülenir. Ayrıca kümeyi başlatıp durdurabilir ve doğrudan kümenin sayfa ayrıntılarına gidebilirsiniz.
İpucu
İşler kümesinin başlatılmasını beklemek istemiyorsanız, seçili kümeyi geliştirme modunda paket işlerini çalıştırmak için kullanmak üzere küme seçiminin hemen altındaki pakette İşler kümesini geçersiz kıl seçeneğini işaretleyin.
Var olan bir kümeyi kullanma
Kullanmak istediğiniz mevcut bir Azure Databricks kümeniz varsa:
Yapılandırma görünümünde, Küme'nin yanındaki Küme seç'e veya dişli (Kümeyi yapılandır) simgesine tıklayın.
Komut Paleti'nde, kullanmak istediğiniz kümeyi seçin.
Yeni küme oluşturma
Mevcut bir Azure Databricks kümeniz yoksa veya yeni bir küme oluşturmak istiyorsanız:
Yapılandırma görünümünde, Küme'nin yanındaki dişli (Kümeyi yapılandır) simgesine tıklayın.
Komut Paleti'nde Yeni Küme Oluştur'a tıklayın.
Dış web sitesini (Azure Databricks çalışma alanınız) açmanız istendiğinde Aç'a tıklayın.
İstenirse Azure Databricks çalışma alanınızda oturum açın.
Küme oluşturmak için yönergeleri izleyin.
Not
Databricks, Kişisel İşlem kümesi oluşturmanızı önerir. Bu, işlem yönetimi ek yükünü en aza indirerek iş yüklerini hemen çalıştırmaya başlamanızı sağlar.
Küme oluşturulduktan ve çalıştırıldıktan sonra Visual Studio Code'a geri dönün.
Yapılandırma görünümünde, Küme'nin yanındaki dişli (Kümeyi yapılandır) simgesine tıklayın.
Komut Paleti'nde, kullanmak istediğiniz kümeye tıklayın.
Çalışma alanı klasörünüzü Databricks ile eşitleme
Databricks uzantı panelinin Yapılandırma görünümünde Çalışma Alanı Klasörü ile ilişkili eşitleme simgesine (Eşitlemeyi başlat) tıklayarak Databricks projenizle ilişkili uzak Databricks çalışma alanı klasörünü eşitleyebilirsiniz.
Not
Visual Studio Code için Databricks uzantısı yalnızca oluşturduğu çalışma alanı dizinleriyle çalışır. Uzantı tarafından oluşturulmadığı sürece projenizde var olan bir çalışma alanı dizinini kullanamazsınız.
Databricks'te çalışma alanı görünümüne gitmek için Çalışma Alanı Klasörü ile ilişkilendirilmiş dış bağlantı simgesine (Dış bağlantıyı aç) tıklayın.
Uzantı, projenin ilişkili Databricks Varlık Paketi yapılandırmasının eşlemesindeki workspace ayara göre file_path kullanılacak Azure Databricks çalışma alanı klasörünü belirler. Bkz . çalışma alanı.
Not
Visual Studio Code için Databricks uzantısı yalnızca yerel Visual Studio Code projenizdeki dosya değişikliklerinin uzak Azure Databricks çalışma alanınızdaki ilgili çalışma alanı klasörüne tek yönlü, otomatik olarak eşitlenmesini sağlar. Bu uzak çalışma alanı dizinindeki dosyaların geçici olması amaçlanmıştır. Bu değişiklikler yerel projenize geri eşitlenmeyeceği için bu dosyalara uzak çalışma alanınızdan değişiklik başlatmayın.
Visual Studio Code için Databricks uzantısının önceki sürümlerine yönelik çalışma alanı dizin eşitleme özelliğiyle ilgili kullanım ayrıntıları için bkz . Visual Studio Code için Databricks uzantısı için çalışma alanı dizini seçme.
Python ortamınızı ve Databricks Connect'i ayarlama
Yapılandırma görünümünün Python Ortamı bölümü, kod ve not defteri hücrelerini çalıştırmak ve hatalarını ayıklamak için Python sanal geliştirme ortamınızın kolay kurulumunu ve Databricks Connect yüklemesini sağlar. Python sanal ortamları, projenizin Python ve Python paketlerinin uyumlu sürümlerini (bu örnekte Databricks Connect paketi) kullandığından emin olun.
Projenizin Python sanal ortamını yapılandırmak için uzantı panelinin Yapılandırma görünümünde:
- Python Ortamı altındaki kırmızı Sanal Ortamı Etkinleştir öğesine tıklayın.
- Komut Paleti'nde Venv veya Conda'yı seçin.
- Varsa, yüklemek istediğiniz bağımlılıkları seçin.
Ortamları değiştirmek için, Etkin Ortam ile ilişkili dişli simgesine (Sanal ortamı değiştir) tıklayın.
Visual Studio Code'da kod ve not defterlerinin çalıştırılmasını ve hata ayıklamasını sağlayan Databricks Connect'i yükleme hakkında bilgi için bkz . Visual Studio Code için Databricks Uzantısı için Databricks Connect kullanarak kodda hata ayıklama.