AmbienteDatabricks Apps

A execução do seu aplicativo Databricks em um ambiente gerenciado utiliza os seguintes binários e recursos:

• Sistema operacional: Ubuntu 22.04 LTS
• Ambiente Python: Python 3.11, executado em um ambiente virtual dedicado. Todas as dependências estão isoladas dentro deste ambiente. Aplicativos que usam uv podem especificar uma versão diferente do Python. Consulte a seção sobre gerenciamento de dependências para um aplicativo Databricks.
• Versão UV: 0.10.2
• Ambiente Node.js: Node.js versão 22.16. Gerenciar dependências com npm ou pnpm usando um arquivo package.json. Consulte Definir dependências do Node.js.
• Recursos do sistema: Por default, cada aplicativo pode usar até 2 CPUs virtuais (vCPUs) e 6 GB de memória. Configure o tamanho compute para ajustar a alocação de CPU e memória com base nos requisitos da sua carga de trabalho. Consulte Configurar recursos compute para um aplicativo Databricks.

Exibir detalhes do ambiente

Para view o ambiente de um aplicativo específico, incluindo a variável de ambiente e o pacote instalado, acesse Environment tab na página de detalhes do aplicativo. Veja os detalhes de um aplicativo Databricks.

padrão variável de ambiente

As seguintes variáveis de ambiente estão disponíveis em todos os aplicativos:

Variável	Descrição
DATABRICKS_APP_NAME	O nome do aplicativo em execução.
DATABRICKS_WORKSPACE_ID	O ID exclusivo do site Databricks workspace ao qual o aplicativo pertence.
DATABRICKS_HOST	O URL do site Databricks workspace ao qual o aplicativo pertence.
DATABRICKS_APP_PORT	A porta de rede na qual o aplicativo deve escutar.
DATABRICKS_CLIENT_ID	O ID do cliente para a entidade de serviço Databricks atribuída ao aplicativo.
DATABRICKS_CLIENT_SECRET	O segredo do OAuth para a entidade de serviço Databricks atribuída ao aplicativo.

Variável	Descrição
DATABRICKS_APP_NAME	O nome do aplicativo em execução.
DATABRICKS_WORKSPACE_ID	O ID exclusivo do site Databricks workspace ao qual o aplicativo pertence.
DATABRICKS_HOST	O URL do site Databricks workspace ao qual o aplicativo pertence.
DATABRICKS_APP_PORT	A porta de rede na qual o aplicativo deve escutar.
DATABRICKS_CLIENT_ID	O ID do cliente para a entidade de serviço Databricks atribuída ao aplicativo.
DATABRICKS_CLIENT_SECRET	O segredo do OAuth para a entidade de serviço Databricks atribuída ao aplicativo.

Variável de ambiente de telemetria do aplicativo

Ao ativar a telemetria para seu aplicativo, Databricks configura automaticamente a seguinte variável de ambiente no ambiente de execução do aplicativo:

Variável	Valor	Descrição
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4314	O endpointdo coletor OTLP
OTEL_EXPORTER_OTLP_PROTOCOL	grpc	O protocolo de exportação
OTEL_RESOURCE_ATTRIBUTES	workspace.id=<id>,app.name=<name>	Atributos de recurso para contexto de rastreamento
OTEL_SERVICE_NAME	<your_app_name>	O nome do serviço para dados de telemetria
OTEL_BSP_MAX_QUEUE_SIZE	10000	tamanho máximo da fila de abrangência
OTEL_BLRP_MAX_QUEUE_SIZE	10000	Tamanho máximo da fila log
OTEL_BSP_MAX_EXPORT_BATCH_SIZE	512	tamanho dos lotes para exportações de span
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE	512	tamanho dos lotes para exportação log
OTEL_BSP_SCHEDULE_DELAY	1000	Intervalo de exportação Span (ms)
OTEL_BLRP_SCHEDULE_DELAY	1000	intervalo de exportação de logs (ms)

Variável	Valor	Descrição
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4314	O endpointdo coletor OTLP
OTEL_EXPORTER_OTLP_PROTOCOL	grpc	O protocolo de exportação
OTEL_RESOURCE_ATTRIBUTES	workspace.id=<id>,app.name=<name>	Atributos de recurso para contexto de rastreamento
OTEL_SERVICE_NAME	<your_app_name>	O nome do serviço para dados de telemetria
OTEL_BSP_MAX_QUEUE_SIZE	10000	tamanho máximo da fila de abrangência
OTEL_BLRP_MAX_QUEUE_SIZE	10000	Tamanho máximo da fila log
OTEL_BSP_MAX_EXPORT_BATCH_SIZE	512	tamanho dos lotes para exportações de span
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE	512	tamanho dos lotes para exportação log
OTEL_BSP_SCHEDULE_DELAY	1000	Intervalo de exportação Span (ms)
OTEL_BLRP_SCHEDULE_DELAY	1000	intervalo de exportação de logs (ms)

Para saber mais sobre como configurar a telemetria do aplicativo, consulte Configurar a telemetria para Databricks Apps.

Estrutura variável de ambiente

O ambiente de execução do Databricks Apps configura automaticamente as variáveis de porta e host para as estruturas Python compatíveis. Você não precisa configurar isso manualmente. Todas as variáveis de porta estão definidas com o valor DATABRICKS_APP_PORT.

Estrutura	Variáveis
Gradio	GRADIO_SERVER_PORT, GRADIO_SERVER_NAME=0.0.0.0
Streamlit	STREAMLIT_SERVER_PORT, STREAMLIT_SERVER_ADDRESS=0.0.0.0
FastAPI	UVICORN_PORT, UVICORN_HOST=0.0.0.0
Uvicórnio	UVICORN_PORT, UVICORN_HOST=0.0.0.0
Frasco	FLASK_RUN_PORT, FLASK_RUN_HOST=0.0.0.0
Traço	PORT
Expressar	PORT

Estrutura	Variáveis
Gradio	GRADIO_SERVER_PORT, GRADIO_SERVER_NAME=0.0.0.0
Streamlit	STREAMLIT_SERVER_PORT, STREAMLIT_SERVER_ADDRESS=0.0.0.0
FastAPI	UVICORN_PORT, UVICORN_HOST=0.0.0.0
Uvicórnio	UVICORN_PORT, UVICORN_HOST=0.0.0.0
Frasco	FLASK_RUN_PORT, FLASK_RUN_HOST=0.0.0.0
Traço	PORT
Expressar	PORT

Variável de ambiente Streamlit adicional

O ambiente de execução também define as seguintes variáveis específicas do Streamlit:

Variável	Descrição
STREAMLIT_SERVER_HEADLESS	Defina como true para que o Streamlit seja executado sem abrir uma janela do navegador.
STREAMLIT_BROWSER_GATHER_USAGE_STATS	Defina como false para impedir o envio de estatísticas de uso para o Streamlit.

Variável	Descrição
STREAMLIT_SERVER_HEADLESS	Defina como true para que o Streamlit seja executado sem abrir uma janela do navegador.
STREAMLIT_BROWSER_GATHER_USAGE_STATS	Defina como false para impedir o envio de estatísticas de uso para o Streamlit.

Nenhuma biblioteca Node.js é pré-instalada no ambiente Databricks Apps. Liste todas as dependências do Node.js em seu arquivo package.json. Consulte Definir dependências do Node.js.