Ligar ao Azure Synapse Link para Cosmos DB
Este artigo descreve como acessar um banco de dados do Azure Cosmos DB do Azure Synapse Analytics Studio com o Azure Synapse Link.
Pré-requisitos
Antes de conectar um banco de dados do Azure Cosmos DB ao seu espaço de trabalho, você precisará de um:
- Banco de dados existente do Azure Cosmos DB ou crie uma nova conta seguindo as etapas em Guia de início rápido: gerenciar uma conta do Azure Cosmos DB.
- Espaço de trabalho existente do Azure Synapse ou crie um novo espaço de trabalho seguindo as etapas em Guia de início rápido : criar um espaço de trabalho Synapse.
Habilitar o Synapse Link em uma conta de banco de dados 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. Synapse Link traz a capacidade HTAP para um contêiner e suporte interno no Azure Synapse.
Ir para Synapse Studio
No seu espaço de trabalho do Azure Synapse, selecione Iniciar 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 do Azure Synapse
A conexão de um banco de dados do Azure Cosmos DB é feita como um serviço vinculado. Com um serviço vinculado do Azure Cosmos DB, você pode navegar 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 do Azure Cosmos DB seguindo estas etapas:
- Selecione o + ícone perto de Dados.
- Selecione Conectar a dados externos.
- Selecione a API à qual você deseja se conectar, por exemplo, API SQL ou API para MongoDB.
- Selecione Continuar.
- Use um nome amigável para nomear o serviço vinculado. O nome aparecerá no Data Object Explorer e é usado pelos tempos de execução do Azure Synapse para se conectar ao banco de dados e aos contêineres.
- Selecione o nome da conta do Azure 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 Azure Synapse serão roteadas para a região mais próxima onde o repositório analítico está habilitado. Você também pode definir manualmente a região que deseja que seus usuários usem para acessar o repositório analítico do Azure Cosmos DB. Selecione Propriedades de conexão adicionais e, em seguida, selecione Novo. Em Nome da propriedade, insira PreferredRegions. Defina o Valor para a região desejada, por exemplo, WestUS2. (Não há espaços entre as palavras e o número.)
- 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 HTC de um contêiner somente OLTP por meio dos seguintes ícones:
Contentor apenas OLTP:
Contêiner habilitado para HTAP:
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.