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:
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 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çõ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:
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 .
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:
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
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>", ... ] }
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 collections de 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 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: