Fabric için NotebookUtils (eski MSSparkUtils)

Not Defteri Yardımcı Programları (NotebookUtils), Doku Not Defteri'nde yaygın görevleri kolayca gerçekleştirmenize yardımcı olan yerleşik bir pakettir. NotebookUtils'i dosya sistemleriyle çalışmak, ortam değişkenlerini almak, not defterlerini birbirine zincirleme ve gizli dizilerle çalışmak için kullanabilirsiniz. NotebookUtils paketi PySpark (Python) Scala, SparkR not defterleri ve Doku işlem hatlarında kullanılabilir.

Uyarı

  • MsSparkUtils resmi olarak NotebookUtilsolarak yeniden adlandırıldı. Mevcut kod geriye dönük uyumluluğunu sürdürür ve kesintiye neden olan değişiklikler yaratmaz. Sürekli destek ve yeni özelliklere erişim sağlamak için notebookutils sürümüne yükseltilmesini kesinlikle öneririz . mssparkutils ad alanı gelecekte kullanımdan kaldırılacaktır.
  • NotebookUtils, Spark 3.4 (Çalışma zamanı v1.2) ve üzeri ile çalışacak şekilde tasarlanmıştır. Tüm yeni özellikler ve güncelleştirmeler, ileride notebookutils ad alanıyla özel olarak desteklenir.

NotebookUtils modülleri

NotebookUtils aşağıdaki modülleri sağlar. Ayrıntılı belgeleri, kod örneklerini ve en iyi yöntemleri görmek için bir modül seçin.

Modül Namespace Açıklama
Dosya sistemi yardımcı programları notebookutils.fs ADLS 2. Nesil, Azure Blob Depolama ve Lakehouse depolama genelinde dosya ve dizinlerle çalışın. Kopyalama, taşıma, okuma, yazma, silme ve listeleme işlemlerini içerir.
Dosya montaj ve demontaj notebookutils.fs Basitleştirilmiş dosya erişimi için spark düğümlerine yerel bağlama noktaları olarak uzak depolama (ADLS 2. Nesil) ekleyin.
Not defteri çalıştırma ve düzenleme notebookutils.notebook Not defterlerini, DAG desteğiyle paralel yürütme, çalışma alanları arası başvurular ve çıkış değerleri dahil olmak üzere birlikte çalıştırın ve zincirleyin.
Not defteri yönetimi notebookutils.notebook Program aracılığıyla not defteri yapıtları oluşturun, alın, güncelleştirin, silin ve listeleyin.
Kimlik bilgileri yardımcı programları notebookutils.credentials Azure hizmetleri için erişim belirteçleri alın ve Azure Key Vault'tan gizli bilgileri alın.
Lakehouse yardımcı programları notebookutils.lakehouse Lakehouse öğelerini ve tablolarını program aracılığıyla oluşturun, alın, güncelleştirin, silin ve yönetin.
Çalışma zamanı bağlamı notebookutils.runtime Not defteri adı, çalışma alanı ayrıntıları ve yürütme bağlamı gibi oturum bağlam bilgilerine erişin.
Oturum yönetimi notebookutils.session Etkileşimli oturumları durdurun ve Python yorumlayıcısını yeniden başlatın.
Kullanıcı Veri İşlevi (UDF) yardımcı programları notebookutils.udf Not defterlerinden Kullanıcı Verileri İşlevleri'ni alın ve çağırın.
Değişken kitaplığı yardımcı programları notebookutils.variableLibrary Değişken Kitaplığı öğelerinden merkezi olarak yönetilen değişkenlere ve yapılandırmaya erişin.

Kullanılabilir tüm modüllere ve yöntemlere genel bir bakış elde etmek için şunu çalıştırın:

notebookutils.help()

Belirli bir modülle ilgili yardım almak için şunu çalıştırın:

notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()

Bilinen sorunlar

  • 1.2 üzerindeki bir çalışma zamanı sürümü kullanılırken ve notebookutils.help() çalıştırılırken, listelenen fabricClient ve PBIClient API'leri henüz desteklenmemektedir, ancak gelecekteki bir sürümde kullanıma sunulacaktır.