Configurações de acesso a dados

Este artigo descreve como gerenciar propriedades de acesso a dados para armazéns SQL em um espaço de trabalho.

Configurar uma entidade de serviço

Para configurar o acesso de seus armazéns SQL a uma conta de armazenamento do Armazenamento do Azure Data Lake usando entidades de serviço, siga estas etapas:

1. Registre um aplicativo Microsoft Entra ID (anteriormente Azure Ative Directory) e registre as seguintes propriedades:

   • ID do aplicativo (cliente): uma ID que identifica exclusivamente o aplicativo Microsoft Entra ID.
   • ID de diretório (locatário): uma ID que identifica exclusivamente a instância de ID do Microsoft Entra (chamada de ID de diretório (locatário) no Azure Databricks).
   • Segredo do cliente: O valor de um segredo do cliente criado para este registro de aplicativo. O aplicativo usará essa cadeia de caracteres secreta para provar sua identidade.

2. Na sua conta de armazenamento, adicione uma atribuição de função para o aplicativo registrado na etapa anterior para dar acesso à conta de armazenamento.

3. Crie um escopo secreto apoiado pelo Cofre de Chaves do Azure ou com escopo de Databricks, consulte Gerenciar escopos secretos e registre o valor da propriedade de nome do escopo:

   • Nome do escopo: o nome do escopo secreto criado.

4. Se estiver usando o Azure Key Vault, crie um segredo no Azure Key Vault, usando o segredo do cliente no campo Valor. Para obter um exemplo, consulte Etapa 4: Adicionar o segredo do cliente ao Cofre de Chaves do Azure. Mantenha um registo do nome secreto que escolheu.

   • Nome secreto: o nome do segredo do Cofre da Chave do Azure criado.

5. Se estiver usando um escopo apoiado por Databricks, crie um novo segredo usando a CLI do Databricks e use-o para armazenar o segredo do cliente obtido na Etapa 1. Mantenha um registro da chave secreta que você inseriu nesta etapa.

   • Chave secreta: A chave do segredo criado apoiado por Databricks.

   Nota

   Opcionalmente, você pode criar um segredo adicional para armazenar a ID do cliente obtida na Etapa 1.

6. Clique no seu nome de utilizador na barra superior da área de trabalho e selecione a opção Definições no menu suspenso.

7. Clique na guia Computação .

8. Clique em Gerenciar ao lado de SQL warehouses.

9. No campo Configuração de Acesso a Dados, clique no botão Adicionar Entidade de Serviço.

10. Configure as propriedades para a sua conta de armazenamento Azure Data Lake Storage.

11. Clique em Adicionar.

    

    Você verá que novas entradas foram adicionadas à caixa de texto Configuração de Acesso a Dados.

12. Clique em Guardar.

Você também pode editar as entradas da caixa de texto Configuração de Acesso a Dados diretamente.

Configurar propriedades de acesso a dados para armazéns SQL

Para configurar todos os armazéns com propriedades de acesso a dados:

1. Clique no seu nome de utilizador na barra superior da área de trabalho e selecione a opção Definições no menu suspenso.

2. Clique na guia Computação .

3. Clique em Gerenciar ao lado de SQL warehouses.

4. Na caixa de texto Configuração de Acesso a Dados, especifique pares chave-valor que contenham propriedades de metastore.

   Importante

   Para definir uma propriedade de configuração do Spark como o valor de um segredo sem expor o valor secreto ao Spark, defina o valor como {{secrets/<secret-scope>/<secret-name>}}. Substitua <secret-scope> pelo escopo secreto e <secret-name> pelo nome secreto. O valor deve começar com {{secrets/ e terminar com }}. Para obter mais informações sobre essa sintaxe, consulte Gerenciar segredos.

5. Clique em Guardar.

Você também pode configurar propriedades de acesso a dados usando o provedor Databricks Terraform e databricks_sql_global_config.

Propriedades suportadas

• Para uma entrada que termina com *, todas as propriedades dentro desse prefixo são suportadas.

  Por exemplo, spark.sql.hive.metastore.* indica que ambos spark.sql.hive.metastore.jars e spark.sql.hive.metastore.version são suportados, e quaisquer outras propriedades que comecem com spark.sql.hive.metastore.

• Para propriedades cujos valores contêm informações confidenciais, você pode armazenar as informações confidenciais em segredo e definir o valor da propriedade como o nome secreto usando a seguinte sintaxe: secrets/<secret-scope>/<secret-name>.

As seguintes propriedades têm suporte para armazéns SQL:

• spark.sql.hive.metastore.*

• spark.sql.warehouse.dir

• spark.hadoop.datanucleus.*

• spark.hadoop.fs.*

• spark.hadoop.hive.*

• spark.hadoop.javax.jdo.option.*

• spark.hive.*

Para obter mais informações sobre como definir essas propriedades, consulte metastore externo do Hive.