Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI Databricks jest w publicznej wersji testowej.
Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.
Grupa registered-models poleceń w Databricks CLI zawiera polecenia do zarządzania modelami w rejestrze modeli w Unity Catalog. Zarejestrowane modele zapewniają scentralizowaną kontrolę dostępu, inspekcję, pochodzenie i odnajdywanie modeli uczenia maszynowego w obszarach roboczych usługi Databricks. Zobacz Zarządzanie cyklem życia modelu w Unity Catalog.
tworzenie zarejestrowanych modeli w Databricks
Utwórz nowy zarejestrowany model w katalogu Unity Catalog.
Magazyn plików dla wersji w zarejestrowanym modelu będzie znajdować się w domyślnej lokalizacji określonej przez schemat nadrzędny, katalog nadrzędny lub magazyn metadanych.
Aby pomyślne utworzenie zarejestrowanego modelu powiodło się, użytkownik musi spełnić następujące warunki:
- Obiekt wywołujący musi być administratorem magazynu metadanych lub być właścicielem katalogu nadrzędnego i schematu albo mieć
USE_CATALOGuprawnienie na katalog nadrzędny iUSE_SCHEMAuprawnienie na schemat nadrzędny. - Obiekt wywołujący musi mieć uprawnienie
CREATE MODELlubCREATE FUNCTIONw schemacie nadrzędnym.
databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]
Arguments
CATALOG_NAME
Nazwa wykazu, w którym znajduje się schemat i zarejestrowany model.
SCHEMA_NAME
Nazwa schematu, w którym znajduje się zarejestrowany model.
NAME
Nazwa zarejestrowanego modelu.
Opcje
--comment string
Komentarz dołączony do zarejestrowanego modelu.
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
--storage-location string
Lokalizacja w chmurze, w której są przechowywane pliki danych wersji modelu.
Examples
Poniższy przykład tworzy zarejestrowany model w określonym wykazie i schemacie:
databricks registered-models create main my_schema my_model
Poniższy przykład tworzy zarejestrowany model z komentarzem:
databricks registered-models create main my_schema my_model --comment "My model description"
usuwanie zarejestrowanych modeli usługi databricks
Usuń zarejestrowany model i wszystkie jego wersje modelu z określonego katalogu nadrzędnego i schematu.
Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem zarejestrowanego modelu. W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym.
databricks registered-models delete FULL_NAME [flags]
Arguments
FULL_NAME
Trzypoziomowa (w pełni kwalifikowana) nazwa zarejestrowanego modelu.
Opcje
Examples
Poniższy przykład usuwa zarejestrowany model:
databricks registered-models delete main.my_schema.my_model
Databricks usuń-alias zarejestrowanych-modeli
Usuń zarejestrowany alias modelu.
Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem zarejestrowanego modelu. W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym.
databricks registered-models delete-alias FULL_NAME ALIAS [flags]
Arguments
FULL_NAME
Trzypoziomowa (w pełni kwalifikowana) nazwa zarejestrowanego modelu.
ALIAS
Nazwa aliasu.
Opcje
Examples
Poniższy przykład usuwa zarejestrowany alias modelu:
databricks registered-models delete-alias main.my_schema.my_model production
pobierz zarejestrowane modele databricks
Pobierz zarejestrowany model.
Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem (lub mieć EXECUTE uprawnienia do) zarejestrowanego modelu. W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym.
databricks registered-models get FULL_NAME [flags]
Arguments
FULL_NAME
Trzypoziomowa (w pełni kwalifikowana) nazwa zarejestrowanego modelu.
Opcje
--include-aliases
Określa, czy w odpowiedzi mają zostać uwzględnione zarejestrowane aliasy modelu.
--include-browse
Czy uwzględnić zarejestrowane modele w odpowiedzi, dla której podmiot główny może uzyskać dostęp tylko do wybiórczych metadanych.
Examples
Poniższy przykład pobiera informacje o zarejestrowanym modelu:
databricks registered-models get main.my_schema.my_model
Poniższy przykład pobiera informacje o zarejestrowanym modelu, w tym aliasy:
databricks registered-models get main.my_schema.my_model --include-aliases
lista zarejestrowanych modeli databricks
Lista zarejestrowanych modeli. Możesz wyświetlić listę zarejestrowanych modeli w określonym schemacie lub wyświetlić listę wszystkich zarejestrowanych modeli w bieżącym magazynie metadanych.
Zwrócone modele są filtrowane na podstawie uprawnień użytkownika wywołującego. Na przykład administrator magazynu metadanych może wyświetlić listę wszystkich zarejestrowanych modeli. Zwykły użytkownik musi być właścicielem lub mieć EXECUTE uprawnienia do zarejestrowanego modelu, aby otrzymywać zarejestrowane modele w odpowiedzi. W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym.
W odpowiedzi nie ma gwarancji na konkretną kolejność elementów.
databricks registered-models list [flags]
Opcje
--catalog-name string
Identyfikator katalogu, w którym ma zostać wyświetlona lista zarejestrowanych modeli.
--include-browse
Czy uwzględnić zarejestrowane modele w odpowiedzi, dla której podmiot główny może uzyskać dostęp tylko do wybiórczych metadanych.
--max-results int
Maksymalna liczba zarejestrowanych modeli do zwrócenia.
--page-token string
Nieprzezroczysty token do wysłania dla następnej strony wyników (stronicowanie).
--schema-name string
Identyfikator schematu, w którym ma być wyświetlona lista zarejestrowanych modeli.
Examples
Poniższy przykład zawiera listę wszystkich zarejestrowanych modeli w bieżącym magazynie metadanych:
databricks registered-models list
W poniższym przykładzie wymieniono zarejestrowane modele w określonym wykazie:
databricks registered-models list --catalog-name main
W poniższym przykładzie wymieniono zarejestrowane modele w określonym schemacie:
databricks registered-models list --catalog-name main --schema-name my_schema
databricks zarejestrowane-modele ustaw-aliassy
Ustaw alias dla określonego zarejestrowanego modelu.
Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem zarejestrowanego modelu. W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym.
databricks registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]
Arguments
FULL_NAME
Pełna nazwa zarejestrowanego modelu.
ALIAS
Nazwa aliasu.
VERSION_NUM
Numer wersji modelu, do której wskazuje alias.
Opcje
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
Examples
W poniższym przykładzie ustawiono alias dla zarejestrowanego modelu:
databricks registered-models set-alias main.my_schema.my_model production 1
aktualizacja zarejestrowanych modeli Databricks
Zaktualizuj określony zarejestrowany model.
Obiekt wywołujący musi być administratorem magazynu metadanych lub właścicielem zarejestrowanego modelu. W tym ostatnim przypadku obiekt wywołujący musi być również właścicielem lub mieć USE_CATALOG uprawnienie do katalogu nadrzędnego i USE_SCHEMA uprawnienie w schemacie nadrzędnym.
Obecnie można zaktualizować tylko nazwę właściciela lub komentarz zarejestrowanego modelu.
databricks registered-models update FULL_NAME [flags]
Arguments
FULL_NAME
Trzypoziomowa (w pełni kwalifikowana) nazwa zarejestrowanego modelu.
Opcje
--comment string
Komentarz dołączony do zarejestrowanego modelu.
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.
''-new-name string'**
Nowa nazwa zarejestrowanego modelu.
--owner string
Identyfikator użytkownika, który jest właścicielem zarejestrowanego modelu.
Examples
Poniższy przykład aktualizuje komentarz zarejestrowanego modelu:
databricks registered-models update main.my_schema.my_model --comment "Updated model description"
Poniższy przykład aktualizuje nazwę zarejestrowanego modelu:
databricks registered-models update main.my_schema.my_model --new-name my_new_model
Flagi globalne
--debug
Czy włączyć logowanie debugowe.
-h lub --help
Wyświetl pomoc dla Databricks CLI lub dla powiązanej grupy poleceń czy pojedynczego polecenia.
--log-file struna
Ciąg reprezentujący plik do zapisywania dzienników wyjściowych. Jeśli ta flaga nie zostanie określona, wartością domyślną jest zapisywanie dzienników wyjściowych w programie stderr.
--log-format formatowanie
Format typu logu text lub json. Wartość domyślna to text.
--log-level struna
Ciąg reprezentujący poziom formatu zapisu dziennika. Jeśli nie zostanie określony, poziom formatu dziennika jest wyłączony.
-o, --output typ
Typ danych wyjściowych polecenia: text lub json. Wartość domyślna to text.
-p, --profile struna
Nazwa profilu pliku ~/.databrickscfg, którego użyć do uruchomienia polecenia. Jeśli ta flaga nie zostanie określona, zostanie użyty profil o nazwie DEFAULT .
--progress-format formatowanie
Format wyświetlania dzienników postępu: default, , appendinplacelubjson
-t, --target struna
Jeśli ma to zastosowanie, docelowy obiekt pakietu do użycia