Compartilhar via


Funções na configuração do construtor de API de Dados

Ocasionalmente, você precisa referenciar informações em seu arquivo de configuração do Construtor de API de Dados. As funções fornecem funcionalidade programática para referenciar informações de uma configuração. Este artigo lista as funções disponíveis, descreve sua funcionalidade e detalha o uso com exemplos.

@env()

Acessar dados de ambiente no computador local. Retorna um valor de cadeia de caracteres .

{
    "<setting-name>": "@env('connection-string-name')"
}

Essa função geralmente é usada para acessar informações confidenciais cadeia de conexão das variáveis de ambiente no computador local.

Há duas maneiras principais de definir variáveis de ambiente a serem usadas com o construtor de API de Dados. Primeiro, você pode definir a variável de ambiente diretamente no sistema. Em segundo lugar, você pode criar um .env arquivo no mesmo diretório que o arquivo de configuração. Usar um .env arquivo é a maneira recomendada de gerenciar variáveis de ambiente.

Exemplo

Este arquivo de exemplo .env define a DAB_ENVIRONMENT variável de ambiente como Development e a SQL_CONN_STRING variável de ambiente como um valor fictício de Server=localhost;User ID=<user-name>;Password=<password>;.

SQL_CONN_STRING=Server=localhost;User ID=<user-name>;Password=<password>;
DAB_ENVIRONMENT=Development

Agora, use a @env() função para referenciar a SQL_CONN_STRING variável de ambiente.

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "@env('SQL_CONN_STRING')"
  }
}

Para obter mais informações, consulte data-source propriedade de configuração.