Azure Databricks Excel Eklentisini ayarlama

Önemli

Bu özellik Genel Önizleme aşamasındadır.

Uyarı

Azure Databricks Excel Eklentisi Azure Kamu veya Azure Çin bölgelerinde kullanılamaz.

Azure Databricks Excel Eklentisi, Azure Databricks çalışma alanınızı Microsoft Excel bağlar ve verilerden kararlara daha hızlı geçmenize yardımcı olmak için yönetilen Lakehouse verilerini doğrudan elektronik tablolarınıza getirir. Eklenti hem Windows hem de macOS için Web için Excel ve masaüstü sürümlerinde tam olarak desteklenir.

Bu sayfada, Microsoft Excel Azure Databricks Excel Eklentisini ayarlamak için kullanılabilecek iki yöntem açıklanmaktadır. Bu eklenti, Azure Databricks çalışma alanınıza bağlanmak için çoklu oturum açma (SSO) kimlik doğrulamasını kullanır ve veri idaresi ve erişim denetimi için Unity Catalog destekler.

Önkoşullar

Excel Eklentisini yüklemeden önce aşağıdakilere sahip olduğunuzu doğrulayın:

  • Unity Kataloğu'nu etkinleştirerek Azure Databricks çalışma alanına erişim.
  • Çalışma alanı yöneticisinin Excel Connector önizlemesini etkinleştirmesi gerekir. Bkz. Azure Databricks önizlemelerini yönetme.
  • Excel'in bağlanacağı her çalışma alanı için Azure Databricks workspace URL. Özel hesap URL'leri desteklenmez.
  • Azure Databricks SQL erişiminiz var ve en azından SQL ambarında CAN USE iznine sahipsiniz.
  • Çalışma alanınızdaki Unity Kataloğu tablolarından veri okuma izinleri.
  • Excel'nin aşağıdaki sürümlerinden biri:
    • Mac'te Excel 2019 veya üzeri
    • Windows üzerinde Excel (Microsoft 365)
    • Web üzerinde Excel
    • Mac'te Excel (Microsoft 365)
  • Güvenlik duvarı veya bulut güvenlik platformu kullanıyorsanız, eklenti dosyasındaki Azure Databricks çalışma alanı URL'lerini izin verilenler listesine ekleyin.
  • Microsoft Entra kiracınız üçüncü taraf uygulamalar için kullanıcı onayını engelliyorsa, kullanıcıların oturum açabilmesi için Microsoft Entra bir yöneticinin Azure Databricks çoklu oturum açma kurumsal uygulaması için yönetici onayı vermesi gerekir. Oturum açma sırasında "Yönetici onayı gerekiyor" iletisine bakın.

Eklenti dosyasını ayarlama

Uyarı

Eklentiyi Microsoft Market üzerinden dağıtan bir yöneticiyseniz bu bölümü atlayın. Market dağıtımı, eklenti dosyası yerine çalışma alanı erişimini yapılandırmak için PowerShell kullanır. Bkz. Microsoft Marketplace aracılığıyla Dağıtın.

Eklenti dosyası, Excel Azure Databricks güvenli bir şekilde nasıl bağlanacaklarını bildiren küçük bir bağlayıcı dosyasıdır. Eklentinin doğru şekilde yüklenmesini ve Excel her açışınızda güncel kalmasını sağlayan dijital el sıkışması işlevi görür.

eklenti dosyasını indirin ve Azure Databricks Excel Eklentisini kullanacak şekilde ayarlayın.

Databricks, birleştirilmiş bir bildirime sahip olabilmeniz için çok çalışma alanı bildirimini kullanmanızı önerir. Ancak hesap düzeyinde SSO'nuz olmadığından kullanamazsanız login.databricks.com Tek çalışma alanı bildirim yöntemini kullanmanız gerekir.

  1. Azure Databricks Excel add-in dosyasını indirin:

    Excel add-in dosyasını indirme

  2. Çalışma alanı URL'nizi bölümün içinde <AppDomain> olarak AppDomains belirterek eklenti dosyasını düzenleyin. Çalışma alanı URL'niz, tarayıcıda Azure Databricks çalışma alanınıza erişmek için kullandığınız temel URL'dir. Birden çok Azure Databricks çalışma alanı arasında geçiş yapmak için, her çalışma alanı URL'sini eklenti dosyasına ekleyin.

    <AppDomains>
   <!-- DO NOT CHANGE -->
   <AppDomain>https://www.databricks.com</AppDomain>
   <AppDomain>https://login.databricks.com</AppDomain>
   <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
   <!-- EXAMPLE -->
   // highlight-next-line
   <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain>
   // highlight-next-line
   <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain>
</AppDomains>

    Uyarı

    Çalışma alanı URL'nizi biçimlendirme olmadan düz metin olarak yapıştırın. Çoğu metin düzenleyicisinde Ctrl+Shift+V (Windows) veya Command+Shift+V (macOS) kullanın.

  3. Değişikliklerinizi kaydedin. Dosyanın bir .xml formatı olarak düzgün biçimlendirilmiş olduğundan emin olun.

Tek çalışma alanı bildirimi

Hesap düzeyi SSO'nuz ayarlanmadıysa bu adımlar geçerlidir.

Uyarı

Her eklenti dosyası tek bir Azure Databricks çalışma alanına bağlanır. Birden çok çalışma alanına bağlanmak için her çalışma alanı için bu adımları yineleyin ve her çalışma alanına bağlı ayrı bir eklenti dosyası yükleyin.

  1. Aşağıdaki bağlantıya tıklayarak Tek çalışma alanı eklenti dosyasını açın:

    Tek çalışma alanı eklenti dosyası

  2. Sayfayı yerel makinenize dosya .xml olarak kaydedin. Çoğu tarayıcıda sayfaya sağ tıklayın ve Save as öğesini seçin veya Ctrl+S (Windows) veya Command+S (macOS) tuşlarına basın.

  3. Aşağıdaki yer tutucuları değiştirerek eklenti dosyasını düzenleyin:

    • YOUR-SERVER-HOSTNAME — Çalışma alanı sunucunuzun ana bilgisayar adı.
    • YOUR-WORKSPACE-ID — Sayısal çalışma alanı kimliğiniz.

    Çalışma alanı URL’niz, ayrı bir <AppDomain> girişi olarak değil, bu yer tutucular üzerinden yapılandırılır.

  4. Değişikliklerinizi kaydedin. Dosyanın bir .xml formatı olarak düzgün biçimlendirilmiş olduğundan emin olun.

1. Seçenek: Yönetici tarafından yönetilen

Genel yönetici olarak, Azure Databricks Excel Eklentisini kuruluşunuzdaki kullanıcılara dağıtabilirsiniz. Eklenti dosyasını kullanarak eklentiyi özel uygulama olarak dağıtabilir veya Microsoft Market'ten yükleyebilirsiniz.

Azure Databricks Excel Eklentisini Microsoft 365 Yönetici olarak yüklemek için global admin iznine sahip olmanız gerekir. Yönetici olarak, kuruluşunuzdaki hangi kullanıcıların eklentileri kullanabileceğini belirleyebilirsiniz. Microsoft 365 genel yöneticiler hakkında daha fazla bilgi için Microsoft belgelerine bakın.

Uyarı

Databricks, Azure Databricks Excel Eklentisini özel uygulama olarak dağıtmanızı önerir.

Özel bir uygulama olarak dağıt.

Eklentiyi özel bir bildirim dosyası kullanarak dağıtın. Önkoşullar bölümünde sağlanan eklenti dosyasını indirin ve ayarlayın.

  1. Microsoft 365 yönetim merkezi Settings > Tümleşik uygulamalar gidin ve Add-ins bağlantısına tıklayın.
  2. Eklentiyi Dağıt'a ve İleri'ye tıklayın.
  3. Yeni bir eklenti dağıtmak için Özel uygulamaları yükle seçeneğine tıklayın.
  4. Manifest yükleme seçeneğini seçin. Dosya Seç'e tıklayın ve eklenti dosyasını karşıya yükleyin.
  5. Eklentiye hangi kullanıcıların erişmesi gerektiğini seçin.
  6. Dağıt’a tıklayın.

Azure Databricks Excel Eklentisini karşıya yükleme hakkında ayrıntılı adımlar için Microsoft belgelerine bakın.

Microsoft Market'ten dağıtma

Eklentiyi Microsoft Market'ten yükleyin ve çalışma alanı erişimini yapılandırmak için PowerShell'i kullanın.

Önkoşullar

  • PowerShell makinenize yüklenir.
  • Windows PowerShell'i yönetici olarak çalıştırmanız gerekir.

Eklentiyi yükleme

  1. Microsoft 365 yönetim merkezi Settings > Tümleşik uygulamalar gidin ve Uyları Al bağlantısına tıklayın.
  2. "Excel için Azure Databricks Eklentisi" araması yapın.
  3. Şimdi edinin'e tıklayın.
  4. Kullanıcıları Ata altında Yalnızca ben seçeneğini seçerek eklentiyi kendinize dağıtın.
  5. Dağıt’a tıklayın.

Microsoft Market'ten Azure Databricks Excel Eklentisini dağıtma hakkında ayrıntılı adımlar için Microsoft belgelerine bakın.

Çalışma alanı erişimini yapılandırma

Eklentiyi yükledikten sonra, Azure Databricks çalışma alanı URL'lerinizi izin verilenler listesine eklemek için PowerShell'i kullanın.

Uyarı

Office 365 yönetim merkezi PowerShell bağlantısı zaman aşımına neden olabilir. Komut başarısız olursa PowerShell'i yeniden açın ve Connect-OrganizationAddInService komutunu çalıştırarak yeniden bağlanın.

  1. PowerShell'i açın ve yönetici olarak çalıştırın. Daha fazla bilgi için Microsoft belgelerine bakın.

  2. Office 365 merkezi dağıtım modülünü yükleyin ve içeri aktarın:

    Install-Module -Name O365CentralizedAddInDeployment
Import-Module O365CentralizedAddInDeployment

  3. Office 365 kiracınıza yönetici olarak bağlanın ve oturum açın:

    Connect-OrganizationAddInService

  4. Eklentinin dağıtıldığını doğrulayın. Excel için Azure Databricks Eklentisi listede görünmelidir.

    Get-OrganizationAddIn

    Eklenti görünmüyorsa yeniden dağıtılması gerekebilir veya yine de dağıtılmaya devam ediyor olabilir.

  5. İzin verilenler listesi Azure Databricks çalışma alanı URL'leri. Her <workspace-url> birini, izin vermek istediğiniz çalışma alanının URL'si ile değiştirin. İstediğiniz kadar çalışma alanı URL'si ekleyebilirsiniz.

    Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 `
  -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net"

    Azure Databricks ürün kimliği d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

  6. Doğru izin verilenler listesini onaylayın. İzin verdiğiniz çalışma alanı URL'leri AppDomains bölümünde görünmelidir.

    Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052

Eklentiyi test edin

  1. Excel'da Azure Databricks Eklentisini bulun.
  2. Oturum açın ve izin verilenler listesine eklediğiniz çalışma alanlarından birine bağlanın.

Uyarı

İzin verilenler listesine ekleme değişikliklerinin eşitlenmesi birkaç dakika sürebilir. Kimlik doğrulaması başarısız olursa, izin verilenler listesine alınmış bir çalışma alanına bağlandığınızdan emin olun. Çalışma alanı doğruysa Excel kapatın, birkaç dakika bekleyin ve yeniden deneyin.

Kuruluşunuza dağıtın

  1. Microsoft 365 yönetici merkezine gidin ve Ayarlar > Tümleşik uygulamalar seçeneğine tıklayın.
  2. Yükleyip yapılandırdığınız Azure Databricks Eklentisini seçin.
  3. Kullanıcılar sekmesine tıklayın ve kuruluşunuzun tamamına mı yoksa belirli bir kullanıcı grubuna mı dağıtılacağınızı seçin.

Uyarı

Yönetici olarak, izin verilen çalışma alanlarıyla ilişkili hesap adını Azure Databricks Excel Eklentisini kullanmayı planlayan kullanıcılarla paylaşın. Bkz. Eklentide oturum açma.

Seçenek 2: Self servis

Yükleme adımları Excel platformunuza bağlı olarak değişir. Önkoşullar bölümünde sağlanan eklenti dosyasını indirin ve ayarlayın.

Web için Excel

Web için Excel'deki Excel Eklentisi'ni yüklemek ve bağlanmak için aşağıdakileri yapın:

  1. Web için Excel açın ve çalışma kitabı oluşturun veya açın.
  2. Giriş sekmesinin altında Eklentiler>Gelişmiş'e tıklayın.
  3. Eklentimi Karşıya Yükle'ye tıklayın.
  4. Eklenti dosyasını karşıya yükleyin.
  5. Yükle'ye tıklayın.
  6. Add-ins menüsünden Azure Databricks Eklentisini bulun ve tıklayın.
  7. Azure Databricks hesabınızda oturum açın. Bir hata varsa açılır iletişim kutularını etkinleştirdiğinizden emin olun.
  8. Birden çok çalışma alanı URL'sini yapılandırdıysanız, istediğiniz Azure Databricks hesap adını seçin. Yalnızca URL'ler aynı hesaptaysa belirli bir çalışma alanını seçmeniz gerekir. Hesap adları hakkında daha fazla bilgi için bkz. Hesap kimliğinizi bulma.

Excel Masaüstü (Windows)

Windows için Excel Desktop'ta Excel Eklentisini yüklemek için aşağıdakileri yapın:

  1. Yerel sürücünüzde adlı Manifest bir klasör oluşturun (örneğin, C:\Manifest).
  2. Eklenti dosyasını klasöre C:\Manifest kopyalayın.
  3. Klasör özelliklerini açın ve klasörü paylaşın:
    1. Klasöre sağ tıklayın ve Manifest seçin.
    2. Paylaş seçeneğine tıklayın ve kendinizi okuma ve yazma izinleri olan bir kullanıcı olarak ekleyin.>
  4. Excel Masaüstü'nü açın.
  5. Excel bildirim klasörüne güvenecek şekilde yapılandırın:
    1. Dosya>Seçenekler>Güven Merkezi>Güven Merkezi Ayarları'na tıklayın.
    2. Kenar çubuğunda Güvenilen Eklenti Katalogları'na tıklayın.
    3. Katalog Url'sinde, eklenti dosyasının bulunduğu paylaşılan klasörün yolunu girin (örneğin, \\YourComputerName\Manifest).
    4. Katalog ekle'ye tıklayın.
    5. Menüde Göster onay kutusunu seçin.
    6. Değişikliklerinizi kaydetmek için Tamam'a tıklayın.
  6. Excel Masaüstü'nü yeniden başlatın.
  7. Başlık çubuğundaki arama kutusunda "Eklenti Olarak Ekle" araması yapın ve sonuçlardan seçin.
  8. Azure Databricks bağlayıcısını seçin ve Add öğesine tıklayın.
  9. Azure Databricks Eklentisi'ne tıklayın ve Azure Databricks hesabınızda oturum açma işlemini tamamlayın.
  10. Birden çok çalışma alanı URL'sini yapılandırdıysanız, istediğiniz Azure Databricks hesap adını seçin. Yalnızca URL'ler aynı hesaptaysa belirli bir çalışma alanını seçmeniz gerekir. Hesap adları hakkında daha fazla bilgi için bkz. Hesap kimliğinizi bulma.

Excel Desktop (macOS)

macOS için Excel Desktop'ta Excel Eklentisini yüklemek için aşağıdakileri yapın:

  1. Microsoft Office Eklentileri klasörünüzü bulun. Varsayılan olarak, dizin şöyledir:

    /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

  2. Eklenti dosyasını bu klasöre kopyalayın.

  3. Excel Desktop'ü açın veya yeniden başlatın.

  4. Gezinti çubuğundaEklentilerim'e> tıklayın.

  5. Azure Databricks Eklentisi'ne tıklayın.

  6. Azure Databricks hesabınızda oturum açma işlemini tamamlayın.

  7. Birden çok çalışma alanı URL'sini yapılandırdıysanız, istediğiniz Azure Databricks hesap adını seçin. Yalnızca URL'ler aynı hesaptaysa belirli bir çalışma alanını seçmeniz gerekir. Hesap adları hakkında daha fazla bilgi için bkz. Hesap kimliğinizi bulma.

Eklentide oturum açma

Kuruluşunuzdaki bir yönetici Azure Databricks Excel Eklentisini dağıttıysa oturum açın ve Excel'dan Azure Databricks çalışma alanınıza bağlanın.

  1. Excel'da, Giriş sekmesinin altında Azure Databricks Eklentisi'ne tıklayın.
  2. Çalışma alanı URL'nizi girin veya açılan listeden daha önce kullanılan bir çalışma alanı URL'sini seçin. Eklenti, sizin veya yöneticinizin yapılandırmış olduğu çalışma alanı URL'lerini anımsar.
  3. Sign in öğesine tıklayın ve tüm Azure Databricks Excel Eklenti özelliklerine erişmek için kimlik doğrulama işlemini tamamlayın.

Azure Databricks çalışma alanını değiştirme

Eklenti dosyanız birden çok Azure Databricks çalışma alanı belirtiyorsa, bu çalışma alanları arasında geçiş yapabilirsiniz. Daha fazla bilgi için bkz. Eklenti dosyasını ayarlama.

Farklı bir Azure Databricks çalışma alanına bağlanmak için aşağıdakileri yapın:

  1. Azure Databricks Eklentisi bölmesinin sağ üst kısmında işlem seçicisinin yanındaki üç noktalı menüye tıklayın.
  2. Çalışma alanını değiştir'e tıklayın.
  3. Çalışma alanınızı barındıran hesabı ve istenirse çalışma alanını seçin, ardından oturum açın.

Sorun giderme

Oturum açma sırasında "Kimlik doğrulaması sürüyor" iletisi

Eklentiden Azure Databricks oturum açmaya çalışırken "Kimlik doğrulaması devam ediyor" penceresi görürseniz, çalışma alanınız özel eklenti dosyasına doğru şekilde eklenmemiş olabilir. altında <AppDomains>çalışma alanınızı doğru yapılandırdığınızdan emin olun.

Oturum açma sırasında "Yönetici onayı gerekiyor" iletisi

Microsoft Entra kiracısı Azure Databricks uygulaması için kullanıcı onayını engellediğinden, Excel add-in Azure Databricks çalışma alanınızda oturum açtığınızda aşağıdaki "Yönetici onayı gerekiyor" iletisi görüntülenir. Yönetici onayı verilmezse Microsoft Entra ID doğrudan çalışma alanı erişiminiz olsa bile oturum açma akışını engellemeye devam eder.

Excel Eklentisinde Yönetici Onayı Gerekiyor Mesajı

Bu sorunu çözmek için, uygun yönetici rollerine sahip Microsoft Entra bir kullanıcının Azure Databricks kurumsal uygulamasına kiracı genelinde yönetici onayı vermesi gerekir.

Microsoft Entra yöneticisinden aşağıdaki bağlantıyı ziyaret etmesini isteyin. {TENANT_ID} öğesini Microsoft Entra kiracı kimliğinizle değiştirin:

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Bağlantı başarısız olursa yönetici el ile onay verebilir:

  1. Microsoft Entra yönetim merkeziEntra ID>Enterprise apps>Tüm uygulamalar gidin ve çoklu oturum açma için kullanılan Azure Databricks kurumsal uygulamayı bulun. Uygulamayı tanımlamak için Uygulama Kimliği'ni aaec40b0-c0ae-4211-a98b-6fc160abb71barayın.
  2. Azure Databricks kurumsal uygulaması tarafından istenen izinler için yönetici onayı verin:
    1. Güvenlik'in altında İzinler'e tıklayın.
    2. Yönetici onayı ver'e tıklayın.

Ayrıntılı yönergeler için Microsoft belgelerine bakın.

Kaynaklar kullanılamaz

SQL ambarları gibi Azure Databricks kaynaklarını kullanamıyorsanız, Azure Databricks Eklentisi'nde kullandığınız Excel sürümüne bağlı olarak aşağıdaki yöntemlerden birini deneyin:

  • Web için Excel: Sayfayı yeniden başlatın veya çalışma alanlarını değiştirin ve aynı çalışma alanında yeniden oturum açın. Bkz. Azure Databricks çalışma alanını değiştirme.
  • Excel Desktop: Sağ üst köşedeki bilgi simgesine tıklayıp Yükle'i seçerek eklentiyi yeniden yükleyin.

Sonraki Adımlar

  • Last updated on