Partilhar via

Obter identificadores para objetos de espaço de trabalho

  • Artigo

Este artigo explica como obter URLs e identificadores de espaço de trabalho, cluster, painel, diretório, modelo, bloco de anotações e trabalho no Azure Databricks.

Nomes de instância, URLs e IDs do espaço de trabalho

Um nome de instância exclusivo, também conhecido como URL por espaço de trabalho, é atribuído a cada implantação do Azure Databricks. É o nome de domínio totalmente qualificado usado para fazer logon em sua implantação do Azure Databricks e fazer solicitações de API.

Um espaço de trabalho do Azure Databricks é onde a plataforma Azure Databricks é executada e onde você pode criar clusters do Spark e agendar cargas de trabalho. Um espaço de trabalho tem um ID de espaço de trabalho numérico exclusivo.

URL por área de trabalho

O URL exclusivo por espaço de trabalho tem o formato adb-<workspace-id>.<random-number>.azuredatabricks.net. O ID do espaço de trabalho aparece imediatamente após adb- e antes do "ponto" (.). Para o URL https://adb-5555555555555555.19.azuredatabricks.net/por espaço de trabalho:

  • O nome da instância é adb-5555555555555555.19.azuredatabricks.net.
  • O ID do espaço de trabalho é 5555555555555555.

Determinar URL por espaço de trabalho

Você pode determinar a URL por espaço de trabalho para seu espaço de trabalho:

URL regional herdada

Importante

Evite usar URLs regionais herdadas. Eles podem não funcionar para novos espaços de trabalho, são menos confiáveis e exibem desempenho inferior aos URLs por espaço de trabalho.

A URL regional herdada é composta pela região onde o espaço de trabalho do Azure Databricks é implantado mais o domínio azuredatabricks.net, por exemplo, https://westus.azuredatabricks.net/.

  • Se você fizer login em uma URL regional herdada, como https://westus.azuredatabricks.net/, o nome da instância será westus.azuredatabricks.net.
  • O ID do espaço de trabalho aparece na URL somente depois que você fizer login usando uma URL regional herdada. Aparece depois do o=. No URL https://<databricks-instance>/?o=6280049833385130, o ID do espaço de trabalho é 6280049833385130.

URL e ID do cluster

Um cluster do Azure Databricks fornece uma plataforma unificada para vários casos de uso, como a execução de pipelines de ETL de produção, análise de streaming, análise ad-hoc e aprendizado de máquina. Cada cluster tem uma ID exclusiva chamada ID de cluster. Isso se aplica a clusters polivalentes e de trabalho. Para obter os detalhes de um cluster usando a API REST, a ID do cluster é essencial.

Para obter a ID do cluster, clique na guia Clusters na barra lateral e selecione um nome de cluster. O ID do cluster é o número após o /clusters/ componente na URL desta página

https://<databricks-instance>/#/setting/clusters/<cluster-id>

Na captura de tela a seguir, a ID do cluster é 0831-211914-clean632.

URL do Cluster

URL e ID do painel

Um painel de IA/BI é uma apresentação de visualizações de dados e comentários. Cada painel tem um ID exclusivo. Você pode usar essa ID para construir links diretos que incluam valores de filtro e parâmetro predefinidos ou acessar o painel usando a API REST.

  • Exemplo de URL do painel:

    https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f

  • Exemplo de ID do painel: 01ef9214fcc7112984a50575bf2b460f

URL e ID do bloco de notas

Um bloco de anotações é uma interface baseada na Web para um documento que contém código executável, visualizações e texto narrativo. Os blocos de anotações são uma interface para interagir com o Azure Databricks. Cada bloco de notas tem um ID único. O URL do bloco de notas tem o ID do bloco de notas, pelo que o URL do bloco de notas é exclusivo de um bloco de notas. Ele pode ser compartilhado com qualquer pessoa na plataforma Azure Databricks com permissão para exibir e editar o bloco de anotações. Além disso, cada comando do bloco de anotações (célula) tem uma URL diferente.

Para encontrar um URL ou ID do bloco de notas, abra um bloco de notas. Para localizar um URL de célula, clique no conteúdo do comando.

  • Exemplo de URL do bloco de notas:

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342`

  • Exemplo de ID do bloco de notas: 1940481404050342.

  • Exemplo de URL de comando (célula):

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342/command/2432220274659491

ID da pasta

Uma pasta é um diretório usado para armazenar arquivos que podem ser usados no espaço de trabalho do Azure Databricks. Esses arquivos podem ser blocos de anotações, bibliotecas ou subpastas. Há um id específico associado a cada pasta e a cada subpasta individual. A API de permissões refere-se a essa id como um directory_id e é usada na definição e atualização de permissões para uma pasta.

Para recuperar o directory_id , use a API de espaço de trabalho:

curl -n -X GET -H 'Content-Type: application/json' -d '{"path": "/Users/me@example.com/MyFolder"}' \
https://<databricks-instance>/api/2.0/workspace/get-status

Este é um exemplo da resposta de chamada de API:

{
  "object_type": "DIRECTORY",
  "path": "/Users/me@example.com/MyFolder",
  "object_id": 123456789012345
}

Model ID

Um modelo refere-se a um modelo registrado MLflow, que permite gerenciar modelos MLflow em produção por meio de transições de estágio e controle de versão. O ID do modelo registrado é necessário para alterar as permissões no modelo programaticamente por meio da API de Permissões.

Para obter a ID de um modelo registrado, você pode usar o ponto de extremidade mlflow/databricks/registered-models/getda API de espaço de trabalho . Por exemplo, o código a seguir retorna o objeto de modelo registrado com suas propriedades, incluindo sua ID:

curl -n -X GET -H 'Content-Type: application/json' -d '{"name": "model_name"}' \
https://<databricks-instance>/api/2.0/mlflow/databricks/registered-models/get

O valor retornado tem o formato:

{
  "registered_model_databricks": {
    "name":"model_name",
    "id":"ceb0477eba94418e973f170e626f4471"
  }
}

URL e ID de Trabalhos

Um trabalho é uma forma de executar um notebook ou JAR imediatamente ou de forma programada.

Para obter um URL de trabalho, clique em Ícone Fluxos de Trabalho Fluxos de trabalho na barra lateral e clique no nome de um trabalho. O ID do trabalho está após o texto #job/ no URL. A URL do trabalho é necessária para solucionar a causa raiz de execuções de trabalho com falha.

Na captura de tela a seguir, a URL do trabalho é:

https://westus.azuredatabricks.net/?o=6280049833385130#job/1

Neste exemplo, o ID do trabalho é 1.

URL da Tarefa