Compartilhar via


Início Rápido: Conectar-se ao Link do Azure Synapse para Azure Cosmos DB

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

Pré-requisitos

Antes de conectar uma conta Azure Cosmos DB ao espaço de trabalho, algumas coisas são necessárias.

  • Conta do Azure Cosmos DB existente ou criar uma nova conta após este início rápido
  • Espaço de trabalho Synapse existente ou criar um novo espaço de trabalho após este início rápido

Habilitar o repositório analítico do Azure Cosmos DB

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. Essa função traz o recurso HTAP para um contêiner e o suporte interno no Azure Synapse. Siga este início rápido para habilitar o Link do Synapse para os contêineres do Azure Cosmos DB.

Em seu espaço de trabalho do Synapse, selecione Inicializar Synapse Studio. Na home page do Synapse Studio, selecione **Dados, o que o levará para o Pesquisador de Objetos de Dados.

Conectar um banco de dados Azure Cosmos DB a um espaço de trabalho Synapse

A conexão de um banco de dados Azure Cosmos DB é feita como um serviço vinculado. Um serviço vinculado do Azure Cosmos DB permite que os usuários procurem e explorem dados, leiam e gravem do Apache Spark para Azure Synapse Analytics ou SQL no Azure Cosmos DB.

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

  1. Selecione o ícone + ao lado de Dados.
  2. Selecione Conectar a dados externos
  3. Selecione a API à qual deseja se conectar: SQL ou MongoDB
  4. Selecione Continuar
  5. Nomeie o serviço vinculado. O nome será exibido no Pesquisador de Objetos e usado pelos tempos de execução do Synapse para conectar ao banco de dados e aos contêineres. Recomendamos usar um nome amigável.
  6. Selecione o nome da conta 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 Synapse serão roteadas para a região mais próxima na qual o repositório analítico estiver habilitado. No entanto, 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, grave as PreferredRegions e defina o Valor para a região desejada (exemplo: WestUS2, não há espaço entre palavras e números)
  8. Selecione Criar

Os bancos de dados Azure Cosmos DB estão na guia Vinculado, na seção Azure Cosmos DB. Você pode diferenciar um contêiner Azure Cosmos DB habilitado para HTAP de um contêiner somente OLTP com os seguintes ícones:

Contêiner Synapse :

Contêiner HTAP

Contêiner somente OLTP:

Contêiner OLTP

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 inicializarão uma 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