Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Database Hub no Microsoft Fabric ajuda você a descobrir contas do Azure Cosmos DB em APIs (NoSQL, MongoDB, Cassandra, Gremlin, Table).
Dica
💡 Configuração de agente para o Database Hub
Comece a usar as habilidades dos agentes do Database Hub para entender e interagir com o Database Hub no Fabric:
- Use [Database Hub skills](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh).
- Review [Database Hub in Fabric documentation](https://learn.microsoft.com/fabric/database/hub/)
and use the [Microsoft Learn MCP server](https://learn.microsoft.com/api/mcp) for official docs.
Importante
Esse recurso está na versão prévia.
Monitore o Cosmos DB no ambiente existente
Suas contas do Cosmos DB permanecem recursos do Azure em suas assinaturas, grupos de recursos e regiões existentes. Usar o Database Hub para descoberta e monitoramento não exige transferir dados para o Fabric, configurar o espelhamento ou integrar o Cosmos DB Fleet Analytics.
Métricas do Hub de Banco de Dados descrevem a conta, a menos que uma métrica ou parâmetro de filtro identifique explicitamente um escopo mais restrito, como um banco de dados ou contêiner específico.
- O monitoramento do Cosmos DB no Database Hub utiliza métricas existentes da plataforma Azure Monitor, que são coletadas automaticamente para cada conta sem configuração explícita.
- Você não precisa habilitar os logs de diagnóstico (de recurso) nem aderir ao Cosmos DB Fleet Analytics.
- Azure Monitor e Fleet Analytics são ferramentas separadas, opcionalmente aderidas, para investigações mais profundas, e não são necessárias para preencher métricas de referência.
Pré-requisitos
Nesta versão prévia, peça a um administrador do Fabric que habilite seu locatário para a experiência de versão prévia do Database Hub no portal de administração do Fabric. Em Configurações do locatário, habilite Os usuários podem acessar o hub de banco de dados (versão prévia).
Comece com a experiência gratuita fazendo login com sua conta de trabalho ou escola. Você pode entrar pelo portal do Azure ou diretamente pelo Microsoft Fabric, mesmo que nunca tenha usado o Fabric antes. Autentique com uma identidade Microsoft Entra que tenha acesso às assinaturas do Azure e aos recursos do Cosmos DB com os quais você deseja trabalhar. A visibilidade de recursos do Azure sozinha não concede permissão para consultar um banco de dados. O Database Hub usa suas permissões existentes do Microsoft Entra ID e do Azure RBAC, em vez de um modelo de permissões separado, então o acesso que você atribui aqui segue os passos padrão de atribuição de funções do Azure.
- Para descobrir e monitorar contas do Cosmos DB, atribua a função Leitor, ou uma função com permissões mais amplas, no escopo da assinatura, para cada assinatura que contenha as contas que você deseja monitorar.
- Para criar uma nova conta do Cosmos DB a partir do Database Hub, atribua o papel de Operador do Cosmos DB, ou um papel com maiores permissões, no escopo do grupo de recursos onde a conta será criada.
- Gerenciar ou reconfigurar uma conta existente, como alterar a taxa de transferência, indexação ou configurações de rede, é feito fora do Database Hub, usando o portal Azure, CLI do Azure, Azure PowerShell ou um template do Azure Resource Manager. A mesma identidade precisa da função Operador do Cosmos DB, ou de uma função com permissões maiores, no escopo da conta para fazer essas alterações nela.
Para consultar dados em um banco de dados ou container, sua identidade precisa de uma atribuição separada de função no plano de dados do Cosmos DB (ou chaves de conta, quando permitido), além de acesso à conta em rede. O acesso em nível de recurso (plano de gerenciamento) não concede essa permissão. Para saber mais, veja Connect usando controle de acesso baseado em funções e Microsoft Entra ID para Azure Cosmos DB.
O Database Hub respeita seus limites de acesso existentes. O Database Hub não concede acesso adicional. Sua visibilidade nos bancos de dados é limitada aos recursos que sua identidade atual está autorizada a visualizar. Compartilhar uma visualização ou enviar um link de recurso para alguém não concede acesso ao servidor subjacente.
Veja seu espólio Cosmos DB
Dica
O recurso do Cosmos DB representado no Estate é uma conta de banco de dados, não cada banco de dados ou contêiner hospedado dentro dessa conta.
Use o Database Hub para identificar recursos que precisam de investigação. Continue no portal do Azure ou no Visual Studio Code para configuração de contas, trabalho em nível de contêiner ou diagnósticos de consulta.
- Vá para o Hub de Banco de Dados no Microsoft Fabric. Na navegação de Bancos de Dados, selecione Visão Geral.
- A seção O que precisa de atenção? destaca partes do seu patrimônio de banco de dados que precisam de atenção. Cada cartão e link em O que precisa de atenção? leva a Estate. Na visualização Estate, abaixo de cada recurso, Problemas aparecem em etiquetas coloridas, enquanto Sugestões aparecem em etiquetas com um ícone de lâmpada.
- Filtre o inventário para Ver: Azure Cosmos DB. Selecione as assinaturas ou grupos de recursos relevantes usando os filtros disponíveis.
- Procure a conta que você precisa ou revise o inventário filtrado. Selecione a conta para revisar os detalhes dos recursos. Trate essa conta como o recurso da conta do Azure, não como um banco de dados individual ou contêiner.
Métricas de monitoramento do Cosmos DB no Database Hub
Visão geral exibe a disponibilidade e resumos normalizados do consumo de RU nos recursos da sua conta do Cosmos DB.
Para uma conta bem dimensionada e usada ativamente, é normal ver ambas as linhas em ou próximas de 100% na maior parte do tempo. Alto consumo de RU significa que a conta está usando a maior parte ou a totalidade do throughput provisionado. Se isso é aceitável depende da disponibilidade na mesma janela.
- Alta disponibilidade junto com isso significa que as solicitações ainda estão sendo bem-sucedidas e a conta simplesmente faz uso total do que está provisionado.
- Uma queda na Disponibilidade nesse mesmo momento indica requisições que de fato foram limitadas ou falharam, já que o consumo máximo sustentado de RU é a mesma condição que desencadeia a limitação de taxa.
Preste mais atenção quando a disponibilidade cair de forma perceptível abaixo de 100%. Também fique atento ao consumo de RU que se mantém baixo por um período prolongado, o que pode indicar um throughput provisionado em excesso.
O desempenho oferece uma visão mais detalhada das contas específicas que você seleciona explicitamente. Ele não inclui automaticamente todas as contas no Estate e, se nenhum filtro for aplicado, o gráfico Performance limita a exibição aos 100 primeiros recursos para manter a página responsiva. Antes de tratar um gráfico de desempenho como abrangendo todo o espólio, confirme quais contas estão atualmente selecionadas, pois a seleção com escopo e o inventário completo do seu espólio podem variar.
A ausência de telemetria não significa uso zero nem prova que uma conta está saudável. Verifique se a conta produziu dados durante o intervalo selecionado e se uma métrica se aplica ao seu tipo de API e configuração.
Interpretar sinais de desempenho do Cosmos DB
| Sinal | métrica do Azure Monitor | Agregação | Description |
|---|---|---|---|
| Consumo Normalizado de RU (% de Pico Normalizado de RU) | NormalizedRUConsumption |
Máximo | Utilização de pico de RU/s em todas as faixas de chave de partição da conta, de 0 a 100%. |
| Total de Unidades de Solicitação (Total de RU consumidas) | TotalRequestUnits |
Soma (Total) | Total de RUs consumidas, somadas ao longo do intervalo selecionado. |
| Solicitações Limitadas (429s) |
TotalRequests filtrado por StatusCode 429 |
Count | Contagem bruta de solicitações rejeitadas por excederem a taxa de transferência provisionada. |
| Taxa 429 % |
TotalRequests filtrado por StatusCode 429, dividido pelo total de TotalRequests |
Contagem (proporção) | Porcentagem de solicitações restringidas por excederem o throughput provisionado. |
| Taxa de transferência provisionada (RU/s provisionadas) | ProvisionedThroughput |
Máximo | As RU/s provisionadas para a conta no intervalo selecionado, para que você possa comparar a capacidade provisionada com a consumida. |
| Latência Média (ms) | ServerSideLatencyDirect |
Mediana | Latência média do lado do servidor em milissegundos para requisições feitas no modo de conexão direta. Não inclui latência no modo gateway. |
| % de disponibilidade | ServiceAvailability |
Mediana | Percentual de solicitações que tiveram sucesso durante o intervalo. |
Note
Disponibilidade % em Desempenho usa a agregação Média. O resumo de disponibilidade da página Visão geral usa a agregação Mínimo para destacar valores atípicos.
Os gráficos desta página usam granularidade horária: uma visualização de 24 horas exibe 24 pontos, com a agregação associada. A grade usa um grão de tempo diferente e reduz toda a faixa selecionada para um único valor por conta por coluna, em vez de plotar pontos ao longo do tempo. Por exemplo, o RU % de norma de pico da grade é o valor máximo observado em todo esse intervalo, não um detalhamento por hora.
Para mais informações, consulte Monitorar o Azure Cosmos DB e Métricas com suporte para Microsoft.DocumentDB/databaseAccounts.
Entenda as diferenças de segurança e de recursos do Cosmos DB
A página de Segurança do Database Hub avalia três sinais do Cosmos DB:
- Autenticação do Microsoft Entra ID: se uma conta aplica autenticação apenas com Entra ID ou ainda permite autenticação local (baseada em chaves).
- Chaves gerenciadas pelo cliente (CMK): se a criptografia CMK está ativada ou se a conta depende de chaves gerenciadas pelo serviço.
- Acesso à rede pública: se uma conta tem ele ativado.
Se uma conta permite autenticação local ou não tem CMK ativada, o Database Hub lista isso como uma Sugestão, uma melhoria opcional que você pode fazer quando for conveniente. Uma conta com acesso à rede pública ativado é listada como um Problema, já que isso é tratado como mais sensível ao tempo.
Um sinal de Hub de Banco de Dados reflete o que ele avalia atualmente, não necessariamente o estado completo da configuração de segurança subjacente de uma conta. Por exemplo, uma conta sem CMK habilitada ainda tem criptografia em repouso por padrão usando chaves gerenciadas pela Microsoft, portanto um sinalizador aqui significa "não habilitado para esse recurso específico", em vez de "não protegido". Verifique a configuração atual da conta no portal do Azure antes de agir com base em uma constatação. Veja Configurar chaves gerenciadas pelo cliente para Azure Cosmos DB e Criptografia em repouso no Azure Cosmos DB para mais detalhes.
Esses sinais de segurança oferecem uma visão rápida para ajudar na triagem. Para uma avaliação completa de segurança e remediação, utilize serviços como o Microsoft Defender para Nuvem e os logs de diagnóstico da sua conta junto com o Database Hub.
Continue a investigação no portal do Azure
Você pode usar o portal do Azure para investigar mais a fundo quaisquer problemas, por exemplo, comparando as métricas da mesma conta lado a lado no Database Hub e no portal do Azure.
Dica
Use a extensão do Visual Studio Code para o Cosmos DB para tarefas no plano de dados, como consultar e gerenciar documentos, mas não para analisar métricas de desempenho.
- Selecione a conta pretendida do Cosmos DB no Database Hub. Um painel para esse item se abre no Centro de Banco de Dados.
- Selecione o botão Abrir o portal Azure.
- Vá até a aba Insights e defina o intervalo de tempo. Compare as métricas relevantes em um intervalo de acompanhamento apropriado.
Durante a prévia atual, a guia Insights do portal do Azure oferece uma gama mais ampla de gráficos e métricas; portanto, use-a para ver sinais que o Database Hub ainda não exibe.
Investigue as descobertas de segurança do Cosmos DB
Selecione o resultado do Cosmos DB no resumo de Segurança ou na conta afetada em Ambiente, quando disponível.
Confirme a conta afetada, nome da avaliação, local avaliado e qualquer tempo disponível de observação. Verifique a recomendação em relação à política da sua organização.
Abra a conta no portal do Azure e verifique sua configuração atual. Para autenticação Microsoft Entra, chaves gerenciadas pelo cliente ou acesso público à rede, siga a documentação correspondente do serviço Cosmos DB.
Avalie o impacto da aplicação e obtenha a aprovação necessária antes de fazer uma alteração.
Após a conclusão da alteração autorizada, verifique a configuração no portal Azure. Permitir reavaliação e atualizar o Database Hub; se a descoberta persistir, compare suas evidências com a configuração atual da conta.
Solucionar problemas com dados do Cosmos DB no Database Hub
- Se uma conta do Cosmos DB não aparecer no Espólio, verifique o locatário logado, acesso ao Azure, tipo de recurso, filtros de inventário e autorização.
- Se as métricas de desempenho estiverem faltando ou diferentes entre o Azure Monitor e o Database Hub:
- Escolha um intervalo de tempo em que a conta estava ativamente atendendo solicitações. Verifique se a métrica se aplica ao tipo de API da conta; por exemplo, o mapeamento 429 difere entre NoSQL (StatusCode 429) e API MongoDB (código de erro 16500).
- Abra a mesma conta no portal do Azure e inspecione a métrica correspondente do Azure Monitor na aba Insights. Compare o fuso horário, horários de início e término, agregação e granularidade o mais fielmente possível.
- Se a métrica estiver ausente em ambos os lugares, verifique a atividade da conta e permita o atraso no processamento.
- Se o Azure Monitor tiver dados mas o Database Hub não, atualize a visualização do Database Hub e tente novamente só com essa conta. Se a diferença persistir, entre em contato com o Suporte.
Limitações
- O Cosmos DB Fleet Analytics atualmente não é suportado no Database Hub.
- A prévia atual suporta apenas contas do Azure Cosmos DB. Na prévia atual, o Cosmos DB no Fabric não é suportado no momento.
- Na prévia atual, Visão Geral e Desempenho apresentam um subconjunto selecionado das métricas disponíveis no Azure Monitor.
- Na prévia atual, alertas do Ativador sobre métricas do Cosmos DB não estão disponíveis.