Início Rápido: Ligar ao Azure Synapse Link para o Azure Cosmos DB
Este artigo descreve como aceder a uma base de dados do Azure Cosmos DB a partir do Azure Synapse Analytics Studio com Synapse Link.
Pré-requisitos
Antes de ligar uma conta do Azure Cosmos DB à área de trabalho, existem algumas coisas de que precisa.
- Conta existente do Azure Cosmos DB ou criar uma nova conta após este início rápido
- Área de trabalho existente do Synapse ou criar uma nova área de trabalho após este início rápido
Ativar o arquivo analítico do Azure Cosmos DB
Para executar análises em grande escala no Azure Cosmos DB sem afetar o desempenho operacional, recomendamos que ative Synapse Link para o Azure Cosmos DB. Esta função traz a capacidade HTAP para um contentor e suporte incorporado no Azure Synapse. Siga este início rápido para ativar Synapse Link para contentores do Azure Cosmos DB.
Navegue para Synapse Studio
Na área de trabalho do Synapse, selecione Iniciar Synapse Studio. Na home page do Synapse Studio, selecione **Dados, que o levarão para a Object Explorer de Dados.
Ligar uma base de dados do Azure Cosmos DB a uma área de trabalho do Synapse
A ligação de uma base de dados do Azure Cosmos DB é feita como um serviço ligado. Um serviço ligado do Azure Cosmos DB permite aos utilizadores procurar e explorar dados, ler e escrever a partir do Apache Spark para Azure Synapse Analytics ou SQL no Azure Cosmos DB.
A partir da Object Explorer de Dados, pode ligar diretamente uma base de dados do Azure Cosmos DB através dos seguintes passos:
- Ícone Selecionar + perto de Dados
- Selecione Ligar a dados externos
- Selecione a API à qual pretende ligar: SQL ou MongoDB
- Selecione Continuar
- Atribua um nome ao serviço ligado. O nome será apresentado no Object Explorer e utilizado pelos run times do Synapse para ligar à base de dados e aos contentores. Recomendamos que utilize um nome amigável.
- Selecione o nome da conta do Cosmos DB e o nome da base de dados
- (Opcional) Se não for especificada nenhuma região, as operações de tempo de execução do Synapse serão encaminhadas para a região mais próxima onde o arquivo analítico está ativado. No entanto, pode definir manualmente a região onde pretende que os seus utilizadores acedam ao arquivo analítico do Azure Cosmos DB. Selecione Propriedades de ligação adicionais e, em seguida , Nova. Em Nome da Propriedade, escreva PreferredRegions e defina o Valor para a região que pretende (por exemplo: UUS Oeste2, não existe espaço entre palavras e números)
- Selecione Criar
As bases de dados do Azure Cosmos DB estão visíveis no separador Ligado na secção Azure Cosmos DB. Pode diferenciar um contentor do Azure Cosmos DB com HTAP ativado a partir de um contentor apenas OLTP com os seguintes ícones:
Contentor do Synapse:
Apenas contentor OLTP:
Interagir rapidamente com ações geradas por código
Ao clicar com o botão direito do rato num contentor, terá uma lista de gestos que acionarão um run-time do Spark ou do SQL. A escrita num contentor ocorrerá através do Arquivo Transacional do Azure Cosmos DB e consumirá Unidades de Pedido.