Guia de início rápido: conectar-se ao Azure Synapse Link para Azure Cosmos DB
Este artigo descreve como acessar um banco de dados do Azure Cosmos DB do Azure Synapse Analytics studio com Synapse Link.
Pré-requisitos
Antes de conectar uma conta do Azure Cosmos DB ao seu espaço de trabalho, há algumas coisas de que você precisa.
- Conta existente do Azure Cosmos DB ou crie uma nova conta após este início rápido
- Espaço de trabalho Synapse existente ou crie 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 análises em grande escala no Azure Cosmos DB sem afetar seu desempenho operacional, recomendamos habilitar o Synapse Link para Azure Cosmos DB. Essa função traz a capacidade HTAP para um contêiner e suporte interno no Azure Synapse. Siga este início rápido para habilitar o Synapse Link para contêineres do Azure Cosmos DB.
Navegue até Synapse Studio
No espaço de trabalho Synapse, selecione Launch Synapse Studio. Na página inicial do Synapse Studio, selecione **Dados, que o levará ao Pesquisador de Objetos de Dados.
Conectar um banco de dados do Azure Cosmos DB a um espaço de trabalho Synapse
A conexão de um banco de dados do Azure Cosmos DB é feita como serviço vinculado. Um serviço vinculado do Azure Cosmos DB permite que os usuários naveguem e explorem dados, leiam e escrevam 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 do Azure Cosmos DB executando as seguintes etapas:
- Ícone Selecionar + perto de Dados
- Selecione Conectar a dados externos
- Selecione a API à qual você deseja se conectar: SQL ou MongoDB
- Selecione Continuar
- Nomeie o serviço vinculado. O nome será exibido no Pesquisador de Objetos e usado pelos tempos de execução do Synapse para se conectar ao banco de dados e aos contêineres. Recomendamos o uso de um nome amigável.
- Selecione o nome da conta do Cosmos DB e o nome do banco de dados
- (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 onde o repositório analítico está habilitado. No entanto, você pode definir manualmente a região onde 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, escreva PreferredRegions e defina o Valor para a região desejada (exemplo: WestUS2, não há espaço entre palavras e números)
- Selecione Criar
Os bancos de dados do Azure Cosmos DB são visíveis na guia Vinculado na seção Azure Cosmos DB. Você pode diferenciar um contêiner do Azure Cosmos DB habilitado para HTAP de um contêiner somente OLTP com os seguintes ícones:
Recipiente de sinapse:
Contentor apenas OLTP:
Interaja rapidamente com ações geradas por código
Ao clicar com o botão direito do mouse em um contêiner, você terá uma lista de gestos que acionarão um tempo de execução do Spark ou SQL. A gravação em um contêiner acontecerá por meio do Repositório Transacional do Azure Cosmos DB e consumirá Unidades de Solicitação.