Compartilhar via


Conectar-se ao Link do Azure Synapse para Azure Cosmos DB

Este artigo descreve como acessar um banco de dados Azure Cosmos DB pelo Azure Synapse Analytics Studio com o Link do Azure Synapse.

Pré-requisitos

Antes de conectar um banco de dados do Azure Cosmos DB ao workspace, você precisará de:

Para executar a análise em larga escala no Azure Cosmos DB sem afetar o desempenho operacional, recomendamos habilitar o Link do Synapse para o Azure Cosmos DB. O Link do Synapse traz o recurso HTAP para um contêiner e suporte interno no Azure Synapse.

Acessar o Synapse Studio

No seu workspace do Azure Synapse, selecione Inicializar o Synapse Studio. Na home page do Synapse Studio, selecione Dados, o que o leva ao Pesquisador de Objetos de Dados.

Conectar um banco de dados Azure Cosmos DB a um workspace Azure Synapse

A conexão de um banco de dados Azure Cosmos DB é feita como um serviço vinculado. Com um serviço vinculado do Azure Cosmos DB, você pode procurar e explorar dados, ler e gravar do Apache Spark para Azure Synapse Analytics ou SQL no Azure Cosmos DB.

No Pesquisador de Objetos de Dados, você pode se conectar diretamente a um banco de dados Azure Cosmos DB executando essas etapas:

  1. Selecione o ícone + perto de Dados.
  2. Selecione Conectar a dados externos.
  3. Selecione a API à qual você deseja se conectar, por exemplo, API do SQL ou API para MongoDB.
  4. Selecione Continuar.
  5. Use um nome amigável para nomear o serviço vinculado. O nome será exibido no Pesquisador de Objetos de Dados e será usado pelos runtimes do Azure Synapse para se conectar ao banco de dados e contêineres.
  6. Selecione o nome da conta do Azure Cosmos DB e o nome do banco de dados.
  7. (Opcional) Se nenhuma região for especificada, as operações de tempo de execução do Azure Synapse serão roteadas para a região mais próxima na qual o repositório analítico estiver habilitado. Você pode definir manualmente em qual região deseja que os usuários acessem o repositório analítico do Azure Cosmos DB. Selecione Propriedades de conexão adicionais e, em seguida, Novo. Em Nome da propriedade, insira PreferredRegions. Defina o Valor para a região que deseja, por exemplo, WestUS2. (Não há espaços entre as palavras e o número.)
  8. Selecione Criar.

Os bancos de dados do Azure Cosmos DB aparecem na guia Vinculado na seção Azure Cosmos DB. Com o Azure Cosmos DB, você pode diferenciar um contêiner habilitado para HTAP de um contêiner somente OLTP pelos seguintes ícones:

Contêiner somente OLTP:

Visualização que mostra o ícone de contêiner OLTP.

Contêiner habilitado para HTAP:

Visualização que mostra o ícone de contêiner HTAP.

Interagir rapidamente com ações geradas por código

Ao clicar com o botão direito em um contêiner, você terá uma lista de gestos que dispararão um tempo de execução do Spark ou do SQL. A gravação em um contêiner ocorrerá por meio do repositório transacional do Azure Cosmos DB e consumirá Unidades de Solicitação.

Próximas etapas