Narzędzia biblioteki zmiennych NotebookUtils dla Fabric

Biblioteki zmiennych pomagają uniknąć twardego kodowania wartości w kodzie notatnika. Zamiast edytować kod, należy zaktualizować wartości w bibliotece i pobrać je w czasie wykonywania. Ten wzorzec ułatwia ponowne używanie notesów między zespołami i projektami przez scentralizowanie konfiguracji.

W poniższej tabeli wymieniono dostępne metody biblioteki zmiennych:

Definiowanie zmiennych

Zdefiniuj zmienne w bibliotece zmiennych przed użyciem polecenia notebookutils.variableLibrary. Biblioteki zmiennych można tworzyć i zarządzać nimi za pomocą interfejsu użytkownika sieci szkieletowej.

Pobieranie biblioteki zmiennych

Użyj getLibrary() polecenia , aby pobrać całą bibliotekę jako obiekt, a następnie uzyskać dostęp do zmiennych jako właściwości. Użyj składni getVariable('name') lub nawiasu library['name'], jeśli potrzebujesz dostępu dynamicznego.

samplevl = notebookutils.variableLibrary.getLibrary("sampleVL")

# Property access
samplevl.test_int
samplevl.test_str

# Method access (useful for dynamic variable names)
samplevl.getVariable("test_int")

# Bracket access
samplevl["test_int"]

val samplevl = notebookutils.variableLibrary.getLibrary("sampleVL")

samplevl.test_int
samplevl.test_str

samplevl <- notebookutils.variableLibrary.getLibrary("sampleVL")

samplevl$test_int()
samplevl$test_str()

W poniższym przykładzie pokazano, jak dynamicznie konstruować ścieżkę pliku przy użyciu wartości biblioteki zmiennych:

samplevl = notebookutils.variableLibrary.getLibrary("sampleVL")

file_path = f"abfss://{samplevl.Workspace_name}@onelake.dfs.fabric.microsoft.com/{samplevl.Lakehouse_name}.Lakehouse/Files/<FileName>.csv"
df = spark.read.format("csv").option("header","true").load(file_path)

display(df)

Uzyskiwanie dostępu do pojedynczej zmiennej przez odwołanie

get() Użyj metody ze wzorcem $(/**/libraryName/variableName) odwołania, aby pobrać pojedynczą wartość zmiennej. Wartość jest automatycznie wpisywana na podstawie definicji zmiennej.

notebookutils.variableLibrary.get("$(/**/samplevl/test_int)")
notebookutils.variableLibrary.get("$(/**/samplevl/test_str)")
notebookutils.variableLibrary.get("$(/**/samplevl/test_bool)")

notebookutils.variableLibrary.get("$(/**/samplevl/test_int)")
notebookutils.variableLibrary.get("$(/**/samplevl/test_str)")
notebookutils.variableLibrary.get("$(/**/samplevl/test_bool)")

notebookutils.variableLibrary.get("$(/**/samplevl/test_int)")
notebookutils.variableLibrary.get("$(/**/samplevl/test_str)")
notebookutils.variableLibrary.get("$(/**/samplevl/test_bool)")

Obsługiwane typy zmiennych

Biblioteki zmiennych obsługują następujące typy danych. Wartości są automatycznie wpisywane podczas ich pobierania — w większości przypadków nie trzeba ich jawnie rzutować.

Konfiguracja specyficzna dla środowiska

Biblioteki zmiennych umożliwiają obsługę zestawów wartości, które pozwalają definiować alternatywne zestawy wartości dla tych samych zmiennych — na przykład tworzenia, testowania i produkcji. Każdy obszar roboczy ma jeden aktywny zestaw wartości naraz, a potoki wdrażania mogą automatycznie aktywować odpowiedni zestaw wartości na etapie.

Ten schemat eliminuje konieczność wprowadzania zmian w kodzie podczas przenoszenia notesów w różnych środowiskach.

# These values change based on the active value set (dev/test/prod)
app_config = notebookutils.variableLibrary.getLibrary("app_config")

api_endpoint = app_config.api_endpoint
batch_size = app_config.batch_size
debug_mode = app_config.debug_enabled

print(f"API Endpoint: {api_endpoint}")
print(f"Batch Size: {batch_size}")
print(f"Debug Mode: {debug_mode}")

if debug_mode:
    print("Running in debug mode")

val appConfig = notebookutils.variableLibrary.getLibrary("app_config")

val apiEndpoint = appConfig.api_endpoint
val batchSize = appConfig.batch_size
val debugMode = appConfig.debug_enabled

println(s"API Endpoint: ${apiEndpoint}")
println(s"Batch Size: ${batchSize}")
println(s"Debug Mode: ${debugMode}")

if (debugMode) {
    println("Running in debug mode")
}

app_config <- notebookutils.variableLibrary.getLibrary("app_config")

api_endpoint <- app_config$api_endpoint()
batch_size <- app_config$batch_size()
debug_mode <- app_config$debug_enabled()

print(paste("API Endpoint:", api_endpoint))
print(paste("Batch Size:", batch_size))
print(paste("Debug Mode:", debug_mode))

if (debug_mode) {
    print("Running in debug mode")
}

Zagadnienia do rozważenia

Należy pamiętać o następujących kwestiach:

• Interfejs notebookutils.variableLibrary API obsługuje tylko dostęp do bibliotek zmiennych w tym samym obszarze roboczym. Dostęp między obszarami roboczymi nie jest obsługiwany.
• Podczas uruchamiania odwołania nie można pobierać bibliotek zmiennych między obszarami roboczymi w notesach podrzędnych.
• Kod notesu odwołuje się do zmiennych zdefiniowanych w aktywnym zestawie wartości biblioteki zmiennych. Aby użyć różnych wartości, aktywuj inny zestaw wartości w obszarze roboczym lub użyj potoków wdrażania, aby zarządzać zestawami wartości dla każdego środowiska.
• Jednostka usługi (SPN) nie jest obecnie obsługiwana w przypadku narzędzi biblioteki zmiennych.
• Biblioteki zmiennych są tylko do odczytu z notesów. Wprowadź zmiany za pomocą interfejsu użytkownika Fabric lub interfejsów API.
• Każda biblioteka obsługuje maksymalnie 1000 zmiennych i 1000 zestawów wartości, z maksymalnie 10 000 komórek i limitem rozmiaru 1 MB.
• W nazwach zmiennych i bibliotek wielkość liter jest znacząca. Podczas odwoływania się do zmiennych używaj dokładnego dopasowania nazw.

Treści powiązane

• NotebookUtils for Fabric