Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/

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 collections de 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 dá suporte a buckets S3, contêineres do Azure Blob Storage, clusters do Atlas, Atlas Online Archives e URLs acessíveis publicamente como armazenamentos de dados. Você deve definir mapeamentos em sua instância de banco de dados federado para seu bucket S3, cluster do 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:

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 da AWS . 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 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:

  • Quando você cria ou modifica 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 coleção ou visualização utilizando o comando Visualizar Esquema Utilizando o Atlas CLI .

sqlSetSchema

Configure ou exclua o esquema de uma coleção ou visualização usando o comando Editar Esquema Usando o Atlas CLI .

viewAllHistory

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

outToAzure

Grave dados de qualquer um dos armazenamentos de instâncias do banco de dados federados aceitos , ou de vários armazenamentos de instâncias do banco de dados federados 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 dados federados aceitos , ou de vários armazenamentos de instâncias do banco de dados federados 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 .

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
2
3
  • Para uma experiência guiada, clique em Visual Editor.

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

4
5

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.

Você pode executar o seguinte comando para validar sua configuração de 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>",
...
]
}

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.

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 configurar as configurações para gerar coleções curingas (*).

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

← Execute query em sua instância do banco de dados federado