experiments grupo de comando

O experiments grupo de comandos dentro da CLI Databricks permite-lhe criar, editar, eliminar e gerir experiências no MLflow. Consulte Organize treinos com experimentos do MLflow.

experimentos databricks criar-experimento

Crie um experimento com um nome. Retorna a ID do experimento recém-criado. Valida que outro experimento com o mesmo nome ainda não existe e falha se outro experimento com o mesmo nome já existir.

Lança RESOURCE_ALREADY_EXISTS se existir uma experiência com o nome especificado.

databricks experiments create-experiment NAME [flags]

Arguments

NAME

    Nome da experiência.

Opções

--artifact-location string

    Local onde todos os artefatos para o experimento são armazenados.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Experimentos do Databricks Create-Run

Crie uma nova execução dentro de um experimento. Uma execução geralmente é uma única execução de um pipeline de ETL de dados ou aprendizado de máquina. MLflow usa execuções para rastrear mlflowParam, mlflowMetric e mlflowRunTag associados a uma única execução.

databricks experiments create-run [flags]

Arguments

None

Opções

--experiment-id string

    ID da experiência associada.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

--run-name string

    O nome da execução.

--start-time int

    Carimbo de data/hora Unix em milissegundos de quando a execução começou.

--user-id string

    ID do usuário que executa a execução.

Bandeiras globais

exclusão de experiências do databricks delete-experiment

Marque um experimento e metadados associados, execuções, métricas, parâmetros e etiquetas para remoção. Se o experimento usar FileStore, os artefatos associados ao experimento também serão excluídos.

databricks experiments delete-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID da experiência associada.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

Bandeiras globais

experimentos do databricks eliminar execução

Marque uma execução para exclusão.

databricks experiments delete-run RUN_ID [flags]

Arguments

RUN_ID

    ID da execução a ser excluída.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

Bandeiras globais

experimentos databricks excluir-execuções

Eliminar em massa as execuções de um experimento que foram criadas antes ou no carimbo de data/hora especificado. Exclui no máximo max_runs por solicitação. Para chamar essa API de um Databricks Notebook em Python, você pode usar o trecho de código do cliente em

databricks experiments delete-runs EXPERIMENT_ID MAX_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    O identificador do experimento que contém as execuções a serem eliminadas.

MAX_TIMESTAMP_MILLIS

    O carimbo de data/hora máximo de criação em milissegundos desde a época do UNIX para excluir execuções. Somente as execuções criadas antes ou neste carimbo de data/hora são excluídas.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

--max-runs int

    Um inteiro positivo opcional que indica o máximo número de corridas a eliminar.

Bandeiras globais

Databricks experiências eliminar-tag

Remova uma etiqueta durante uma execução. As tags são metadados de execução que podem ser atualizados durante uma execução e após a conclusão de uma execução.

databricks experiments delete-tag RUN_ID KEY [flags]

Arguments

RUN_ID

    ID do processo no qual a etiqueta foi registada. Required.

KEY

    Nome da tag. O tamanho máximo é de 255 bytes. Required.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação

Bandeiras globais

Experiências do Databricks obter-por-nome

Obtenha metadados para uma experiência com o nome especificado.

Esse comando retornará experimentos excluídos, mas prefere o experimento ativo se um experimento ativo e excluído compartilharem o mesmo nome. Se vários experimentos excluídos compartilharem o mesmo nome, a API retornará um deles.

Lança RESOURCE_DOES_NOT_EXIST se não existir nenhum experimento com o nome especificado.

databricks experiments get-by-name EXPERIMENT_NAME [flags]

Arguments

EXPERIMENT_NAME

    Nome da experiência associada.

Opções

Bandeiras globais

Experimentos do Databricks get-experiment

Obtenha metadados para uma experiência com o ID especificado. Este comando funciona em experimentos eliminados.

databricks experiments get-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID da experiência associada.

Opções

Bandeiras globais

Databricks experimentos get-history

Obtenha uma lista de todos os valores para a métrica especificada para uma determinada execução.

databricks experiments get-history METRIC_KEY [flags]

Arguments

METRIC_KEY

    Nome da métrica.

Opções

--max-results int

    Número máximo de registros métricos a serem retornados por solicitação paginada.

--page-token string

    Token que indica a página de históricos métricos a serem buscados.

--run-id string

    ID da execução a partir da qual buscar valores métricos.

--run-uuid string

    Descontinuado, use --run_id em seu lugar. ID da execução a partir da qual buscar valores métricos.

Bandeiras globais

Experimentos do Databricks são executados

Obtenha os metadados, métricas, parâmetros e tags para uma execução. No caso em que várias métricas com a mesma chave são registradas para uma execução, retorne apenas o valor com o carimbo de data/hora mais recente.

Se houver vários valores com o carimbo de data/hora mais recente, retorne o máximo desses valores.

databricks experiments get-run RUN_ID [flags]

Arguments

RUN_ID

    ID da execução para obter. Deve ser fornecido.

Opções

--run-uuid string

    Descontinuado, use --run_id em seu lugar. ID da execução para obter.

Bandeiras globais

Databricks experimentos lista-artefatos

Listar artefactos para uma execução. Usa um prefixo artifact_path opcional que, se especificado, a resposta contém apenas artefatos com o prefixo especificado. Um máximo de 1000 artefatos serão recuperados para volumes do Catálogo Unity. Use databricks fs ls para listar artefatos em volumes do Catálogo Unity, que suporta paginação.

databricks experiments list-artifacts [flags]

Arguments

None

Opções

--page-token string

    O token que indica a página de resultados do artefato a ser buscada.

--path string

    Filtre artefatos correspondentes a esse caminho (um caminho relativo do diretório de artefatos raiz).

--run-id string

    ID da execução cujos artefatos devem ser listados.

--run-uuid string

    Descontinuado, use --run_id em seu lugar. ID da execução cujos artefatos devem ser listados.

Bandeiras globais

experimentos de lista de experimentos databricks

Obtenha uma lista de todos os experimentos.

databricks experiments list-experiments [flags]

Arguments

None

Opções

--max-results int

    Número máximo de experiências desejadas.

--page-token string

    Token que indica a página de experimentos a serem buscados.

--view-type ViewType

    Qualificador para o tipo de experimentos a serem retornados. Valores suportados: ACTIVE_ONLY, ALL, DELETED_ONLY

Bandeiras globais

Registo de processos em lote de experimentos do Databricks

Registre um lote de métricas, parâmetros e tags para uma execução. Se algum dado não for persistente, o servidor responderá com um erro (código de status diferente de 200). Para comportamento de sobrescrição e limites de pedidos, veja Experiências.

databricks experiments log-batch [flags]

Arguments

None

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--run-id string

    ID da execução para iniciar sessão.

Bandeiras globais

Databricks experimenta entradas de log

Registra entradas, como conjuntos de dados e modelos, em uma execução MLflow.

databricks experiments log-inputs RUN_ID [flags]

Arguments

RUN_ID

    ID da execução para registar em

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Databricks experimentos métrica de log

Registre uma métrica para uma execução. Uma métrica é um par chave-valor (chave de cadeia de caracteres, valor flutuante) com um carimbo de data/hora associado. Os exemplos incluem as várias métricas que representam a precisão do modelo de ML. Uma métrica pode ser registrada várias vezes.

databricks experiments log-metric KEY VALUE TIMESTAMP [flags]

Arguments

KEY

    Nome da métrica.

VALUE

    Valor duplicado da métrica a ser registada.

TIMESTAMP

    Carimbo de data/hora Unix em milissegundos no momento em que a métrica foi registada.

Opções

--dataset-digest string

    Resumo analítico do conjunto de dados associado à métrica, por exemplo,

--dataset-name string

    O nome do conjunto de dados associado à métrica.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--model-id string

    ID do modelo registrado associado à métrica, se aplicável.

--run-id string

    ID da execução na qual registar a métrica.

--run-uuid string

    Descontinuado, use --run_id em seu lugar. ID da execução na qual registar a métrica.

--step int

    Etapa para registrar a métrica.

Bandeiras globais

Experimentos de Databricks modelo de registro

Registre um modelo.

databricks experiments log-model [flags]

Arguments

None

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--model-json string

    Ficheiro MLmodel em formato json.

--run-id string

    ID da execução para iniciar sessão.

Bandeiras globais

databricks experimentos log-param

Registe um parâmetro utilizado numa execução. Um parâmetro é um par chave-valor (chave string, valor string). Os exemplos incluem hiperparâmetros usados para treinamento de modelo de ML e datas e valores constantes usados em um pipeline de ETL. Um parâmetro pode ser logado apenas uma vez no decurso de uma execução.

databricks experiments log-param KEY VALUE [flags]

Arguments

KEY

    Nome do parâmetro O tamanho máximo é de 255 bytes.

VALUE

    Valor da string do parâmetro que está sendo registado. O tamanho máximo é de 500 bytes.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--run-id string

    ID da execução sob a qual o parâmetro deve ser registado.

--run-uuid string

    [Preterido, use run_id em vez disso] ID da execução sob a qual se deve registrar o parâmetro.

Bandeiras globais

experimento de restauração de experimentos databricks

Restaure um experimento marcado para exclusão. Isso também restaura metadados, execuções, métricas, parâmetros e tags associados. Se o experimento usar FileStore, os artefatos subjacentes associados ao experimento também serão restaurados.

Lança se o experimento RESOURCE_DOES_NOT_EXIST nunca foi criado ou foi excluído permanentemente.

databricks experiments restore-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID da experiência associada.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Databricks experimentos restauração-execução

Restaure uma execução eliminada. Isso também restaura metadados, execuções, métricas, parâmetros e tags associados.

Lança uma exceção RESOURCE_DOES_NOT_EXIST se a execução nunca foi criada ou foi excluída permanentemente.

databricks experiments restore-run RUN_ID [flags]

Arguments

RUN_ID

    ID da execução para restaurar.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Restaurar execuções de experimentos no Databricks

A restauração em massa é executada em um experimento que não foi excluído antes do carimbo de data/hora especificado. Restaura no máximo max_runs por solicitação.

databricks experiments restore-runs EXPERIMENT_ID MIN_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    A ID do experimento que contém as execuções a serem restauradas.

MIN_TIMESTAMP_MILLIS

    O timestamp mínimo de exclusão em milissegundos desde a época UNIX para restaurar uma execução. Somente as execuções excluídas após este carimbo de data/hora são restauradas.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--max-runs int

    Um inteiro positivo opcional que indica o número máximo de execuções a restaurar.

Bandeiras globais

experimentos databricks pesquisa-experimentos

Procura experiências que satisfaçam critérios de pesquisa especificados.

databricks experiments search-experiments [flags]

Arguments

None

Opções

--filter string

    String que representa uma condição de filtro SQL

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--max-results int

    Número máximo de experiências desejadas.

--page-token string

    Token que indica a página de experimentos a serem buscados.

--view-type ViewType

    Qualificador para o tipo de experimentos a serem retornados. Valores suportados: ACTIVE_ONLY, ALL, DELETED_ONLY

Bandeiras globais

Pesquisas de execuções de experiências no Databricks

Procura processos que satisfaçam expressões. As expressões de pesquisa podem usar as chaves mlflowMetric e mlflowParam.

databricks experiments search-runs [flags]

Arguments

None

Opções

--filter string

    Uma expressão de filtro sobre parâmetros, métricas e tags, que permite retornar um subconjunto de execuções.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--max-results int

    Número máximo de execuções desejadas.

--page-token string

    Token para a página atual de execuções de processos.

--run-view-type ViewType

    Se deseja exibir apenas ativo, somente excluído ou todas as execuções. Valores suportados: ACTIVE_ONLY, ALL, DELETED_ONLY

Bandeiras globais

experimentos databricks set-experiment-tag

Define uma tag em um experimento. As tags de experimento são metadados que podem ser atualizados.

databricks experiments set-experiment-tag EXPERIMENT_ID KEY VALUE [flags]

Arguments

EXPERIMENT_ID

    ID do experimento sob o qual registrar a tag. Deve ser fornecido.

KEY

    Nome da tag. Chaves de até 250 bytes de tamanho são suportadas.

VALUE

    Valor da cadeia de caracteres da tag que está sendo registrada. Valores de até 64KB de tamanho são suportados.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Databricks experiências definir-tag

Atribui uma tag num processamento. As tags são metadados de execução que podem ser atualizados durante uma execução e após a conclusão de uma execução.

databricks experiments set-tag KEY VALUE [flags]

Arguments

KEY

    Nome da tag. Chaves de até 250 bytes de tamanho são suportadas.

VALUE

    Valor da cadeia de caracteres da tag que está sendo registrada. Valores de até 64KB de tamanho são suportados.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--run-id string

    ID da execução sob a qual se deve registar a tag.

--run-uuid string

    Descontinuado, use --run_id em seu lugar. ID da execução sob a qual se deve registar a tag.

Bandeiras globais

experimento de atualização de experimentos databricks

Atualize um experimento.

databricks experiments update-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID da experiência associada.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--new-name string

    Se fornecido, o nome do experimento é alterado para o novo nome.

Bandeiras globais

Experimentos do Databricks Execução de atualização

Atualize uma execução.

databricks experiments update-run [flags]

Arguments

None

Opções

--end-time int

    Timestamp Unix em milissegundos do momento em que a execução terminou.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--run-id string

    ID da execução para atualização.

--run-name string

    Nome atualizado da execução.

--run-uuid string

    Descontinuado, use --run_id em seu lugar. ID da execução para atualização.

--status UpdateRunStatus

    Status atualizado da execução. Valores suportados: FAILED, FINISHED, KILLED, RUNNING, SCHEDULED

Bandeiras globais

Databricks experiências obter níveis de permissão

Consulte níveis de permissão de experimentação.

databricks experiments get-permission-levels EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    O experimento para o qual obter ou gerenciar permissões.

Opções

Bandeiras globais

Experimentos do Databricks obter permissões

Obtenha as permissões de um experimento. Os experimentos podem herdar permissões de seu objeto raiz.

databricks experiments get-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    O experimento para o qual obter ou gerenciar permissões.

Opções

Bandeiras globais

Databricks definir permissões de experimentos

Defina permissões de experimento.

Define permissões em um objeto, substituindo as permissões existentes, se elas existirem. Exclui todas as permissões diretas se nenhuma for especificada. Os objetos podem herdar permissões de seu objeto raiz.

databricks experiments set-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    O experimento para o qual obter ou gerenciar permissões.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Databricks experimenta permissões de atualização

Atualize as permissões do experimento. Os experimentos podem herdar permissões de seu objeto raiz.

databricks experiments update-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    O experimento para o qual obter ou gerenciar permissões.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

    Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor predefinido é text.

--log-level string

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile string

    O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.

--progress-format Formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target string

    Se aplicável, o destino do pacote a ser usado