Partilhar via


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

Ocasionalmente, tem de referenciar informações no ficheiro 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 as respetivas funcionalidades e detalha a utilização com exemplos.

@env()

Aceder aos dados do ambiente no computador local. Devolve um valor de cadeia .

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

Esta função é frequentemente utilizada para aceder a informações confidenciais cadeia de ligação das variáveis de ambiente no computador local.

Existem duas formas principais de definir variáveis de ambiente para utilizar com o construtor de API de Dados. Primeiro, pode definir a variável de ambiente diretamente no sistema. Em segundo lugar, pode criar um .env ficheiro no mesmo diretório que o ficheiro de configuração. Utilizar um .env ficheiro é a forma recomendada de gerir variáveis de ambiente.

Exemplo

Este ficheiro de exemplo .env define a variável de DAB_ENVIRONMENT ambiente como Development e a variável de SQL_CONN_STRING ambiente para 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, utilize a @env() função para referenciar a variável de SQL_CONN_STRING ambiente.

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

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