Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Consultar dados federados

Definir armazéns de dados para uma instância de banco de dados federado

Nesta página

  • Acesso à Data Federation
  • Ações privilegiadas
  • Definir ou atualizar a configuração da instância do banco de dados federado
  • Validar configuração da instância do banco de dados federado
  • Recuperar a configuração do reconhecimento de data center da instância do banco de dados federado
  • Gerar coleções curinga

A criação de uma instância do banco de dados federado começa com a criação de uma configuração de armazenamento no formatoJSON do . A configuração de armazenamento define seus armazenamentos de dados e mapeia esses armazenamentos de dados para collection que você pode query.

O Atlas Data Federation suporte a buckets S3 , contêineres do Azure Blob Storage, clusters Atlas , Atlas Online Archives e URLs acessíveis publicamente como armazenamentos de dados. Você deve definir mapeamentos em sua instância do banco de dados federado para seu bucket S3 , cluster Atlas , Atlas Online Archive e armazenamentos de dados HTTP para executar consultas em seus dados.

Importante

As informações na sua configuração de armazenamento são visíveis internamente no MongoDB e armazenadas como dados operacionais para monitorar e melhorar o desempenho do Atlas Data Federation. Recomendamos que você não use PII em suas configurações.

Esta página descreve os comandos de administração que você pode utilizar para definir, atualizar e recuperar a configuração de armazenamento de instância do reconhecimento de data center federado. Outras páginas nesta seção descrevem as configurações que você pode definir na configuração de armazenamento de instância do reconhecimento de data center federado para seus vários armazenamentos de dados:

Acesso à Data Federation

Ao criar uma instância do banco de dados federado, você concede ao Atlas somente leitura ou acesso de leitura e gravação aos buckets S3 em sua conta do Amazon Web Services . Para acessar seus Atlas clusters, o Atlas usa seuscontroles de acesso baseados em funções existentes. Você pode visualizar e editar a configuração de armazenamento de dados que mapeia os dados dos seus buckets S3 e clusters do Atlas para instâncias de banco de dados federadas e collections virtuais.

Ações privilegiadas

A ação de privilégio define as operações que você pode executar em sua instância do banco de dados federado. Você pode conceder os seguintes privilégios do Atlas Data Federation:

  • Ao criar ou modificar funções personalizadas na interface do usuário do Atlas

  • No parâmetro do corpo da solicitação actions.action ao criar ou atualizar uma função personalizada da APIdo Atlas

sqlGetSchema

Recupere o esquema armazenado para uma collection ou visualização usando o comando Visualizar Esquema Usando mongosh .

sqlSetSchema

Configure ou exclua o esquema de uma collection ou visualização usando o comando Editar Esquema Usando mongosh .

viewAllHistory

Recupere detalhes sobre as queries executadas no passado usando $queryHistory.

outToAzure

Grave dados de qualquer um dos armazenamentos de instâncias do instância do banco de dados federado aceitos , ou de vários armazenamentos de instância do banco de dados federado aceitos em seu contêiner do Azure Blob Storage usando $out.

outToS3

Grave dados de qualquer um dos armazenamentos de instâncias do banco de instância do banco de dados federado aceitos , ou de vários armazenamentos de instância do banco de dados federado aceitos no bucket S3 usando $out.

storageGetConfig

Recupere a configuração de armazenamento da instância do banco de dados federado usando o comando storageGetConfig.

storageSetConfig

Defina ou atualize a configuração de armazenamento da instância do banco de dados federado usando o comando storageSetConfig.

Definir ou atualizar a configuração da instância do banco de dados federado

Após conectado à instância do banco de dados federado, você pode utilizar os seguintes comandos do banco de dados para configurar ou atualizar a configuração da instância do banco de dados federado:

use admin
db.runCommand( { "storageSetConfig" : <config> } )

Substitua <config> pela configuração da instância do banco de dados federado. Você pode validar sua configuração antes de definir ou atualizar a configuração da instância do banco de dados federado executando o comando storageValidateConfig.

Para definir ou atualizar a configuração de armazenamento por meio da interface do usuário do Atlas:

1

Faça login no MongoDB Atlas.

2

Selecione a Data Federation opção na navegação à esquerda.

3

Clique Configuration em para a instância do banco de dados federado e escolha o método de configuração:

  • Para uma experiência guiada, clique em Visual Editor.

  • Para editar o JSON bruto, clique em JSON Editor.

4

Faça as alterações necessárias na configuração de armazenamento da instância do banco de dados federado.

Para managed os armazenamentos de dados na configuração de armazenamento:

Para managed reconhecimento de data center na configuração de armazenamento:

  • Clique em Create Database para adicionar reconhecimento de data center e collection.

    Corresponde à configuração JSON do databases.

  • Clique em para o banco de dados para editar o nome do banco de dados.

    Corresponde à configuração JSON do databases.[n].name.

  • Clique em associado ao banco de dados para remover o banco de dados.

Para gerenciar coleções e visualizações na configuração de armazenamento:

  • Clique em para o:

    • collection para editar o nome da collection.

      Corresponde à configuração JSON do databases.[n].collections.[n].name.

    • Visualizar para editar o nome da visualização e o pipeline.

      Corresponde às definições de configuração JSON do databases.[n].views.[n].name e databases.[n].views.[n].pipeline , respectivamente.

  • Clique em associado ao:

    • Reconhecimento de data center para adicionar collection ao reconhecimento de data center.

      Corresponde à configuração JSON do databases.[n].collections.

    • Coleção para adicionar visualizações sobre a coleção. Para criar uma visualização, você deve especificar:

      • O nome da visualização.

      • O pipeline a ser aplicado à visualização.

      Corresponde à configuração JSON do databases.[n].views.

  • Clique em associado à collection ou visualização para remover a collection ou visualização.

Edite as definições de configuração JSON mostradas na interface do usuário para stores e databases. Para saber mais sobre as definições de configuração, consulte Definir armazenamentos de dados para uma instância de banco de dados federado.

5

Clique Save em para criar a instância do banco de dados federado.

Você também pode definir e managed a configuração de armazenamento usando a seção managed uma instância do banco de dados federado.

Validar configuração da instância do banco de dados federado

É possível executar o comando a seguir para validar a configuração da instância do banco de dados federado.

use admin
db.runCommand( { "storageValidateConfig" : <config> } )

Substitua <config> pela configuração da instância do banco de dados federado.

O comando retorna o seguinte se a configuração da instância do banco de dados federado for válida:

{ "ok" : 1 }

O comando retorna a lista de erros no campo errs se sua configuração de armazenamento da instância do reconhecimento de data center federado for inválida:

{
       "ok" : 1,
       "errs" : [
               "<error>",
               "<error>",
               ...
       ]
}

Recuperar a configuração do reconhecimento de data center da instância do banco de dados federado

Após conectar à instância do banco de dados federado, você pode utilizar os seguintes comandos do banco de dados para recuperar a configuração da instância do banco de dados federado:

use admin
db.runCommand( { "storageGetConfig" : 1 } )

O comando retorna a configuração atual do reconhecimento de data center da instância do banco de dados federado.

Gerar coleções curinga

Você pode gerar dinamicamente nomes de collection que são mapeados para dados em seu bucket S3 ou Atlas cluster. Para gerar nomes de collection dinamicamente, especifique o curinga *, como o valor da configuração do nome da collection na configuração de armazenamento da instância do reconhecimento de data center federado. Não é possível gerar nomes de coleções dinamicamente na configuração de armazenamento da instância do banco de dados federado que sejam mapeados para dados em seu armazenamento de dados HTTP ou HTTPS .

Você pode utilizar o comando storageSetConfig para definir as configurações para gerar coleções curinga (*).

Para saber mais sobre as definições de configuração para gerar coleções de curingas, consulte:

Voltar

Executar queries

Próximo

Balde AWS S3