Esta página contém comandos gerais que você pode usar para definir, atualizar e recuperar a configuração de armazenamento da instância do banco de dados federado . Para uma configuração específica do Armazenamento de Dados, como o AWS S3 criptografia, consulte sua documentação específica do Armazenamento de Dados.
Definir um armazenamento de dados para uma instância do banco de dados federado
Para configurar um armazenamento de dados para uma instância do banco de dados federado, você precisa criar um arquivo JSON de configuração de armazenamento que defina seus armazenamentos de dados e os mapeie para coleções que você pode query. O MongoDB fornece suporte de instância do banco de dados federado para os seguintes armazenamentos de dados:
Importante
As informações na sua configuração de armazenamento são visíveis internamente no MongoDB e armazenar como dados operacionais para monitorar e melhorar o desempenho do Atlas Data Federation. Recomendamos que você não use PII em suas configurações.
Tipos de acesso aos dados
Ao criar uma instância do banco de dados federado, você concede ao Atlas um dos seguintes tipos de acesso aos dados aos buckets da AWS em sua conta da AWS.
Acesso somente leitura: ele não pode fazer alterações nos dados ou adicionar novos dados.
acesso de leitura e gravação: ele pode atualizar arquivos existentes, excluir arquivos ou adicionar novos dados ao armazenamento.
Para acessar seus Atlas clusters, o Atlas usa seus controles de acesso baseado em funções existentes. Você pode visualizar e editar o acesso do seu usuário seguindo as etapas em Gerenciar Usuários e Funções em Implantações Autogerenciadas.
Ações privilegiadas
As ações de privilégio são as operações que você pode executar na instância do banco de dados federado. Você pode conceder a ação de privilégio por meio de uma das seguintes opções:
Ao criar ou modificar funções personalizadas na interface do usuário do Atlas
No parâmetro do corpo da solicitação
actions.actionao criar ou atualizar uma função personalizada da APIdo Atlas
A tabela a seguir mostra as ações de privilégio da instância do banco de dados federado disponíveis:
Comando | Descrição |
|---|---|
Recupere o esquema armazenado para uma coleção ou visualização, consulte Visualizar Esquema Usando | |
Configure ou exclua o esquema de uma coleção ou visualização, consulte Visualizar Esquema Utilizando o | |
Recupere detalhes sobre as queries executadas no passado usando $queryHistory. | |
Grave dados de qualquer um dos armazenamentos de instância do banco de dados federado aceitos, ou de vários armazenamentos de instância do banco de dados federado aceitos no contêiner do Armazenamento de Blobs do Azure usando $out. | |
Gravar dados de qualquer um dos armazenamentos 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. | |
Grave dados de qualquer um dos armazenamentos 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 do Google Cloud Storage usando $out. | |
Recupere a configuração de armazenamento da instância do banco de dados federado usando o comando storageGetConfig. | |
Defina ou atualize a configuração de armazenamento da instância do banco de dados federado usando o comando storageSetConfig. |
Recuperar arquivo de configuração
Para recuperar seu arquivo de configuração da instância do banco de dados federado, conecte-se à sua instância e use o seguinte comando:
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.
Validar arquivo de configuração
Para validar a configuração da instância do banco de dados federado , conecte-se à instância e use o seguinte comando:
use admin db.runCommand( { "storageValidateConfig" : <config> } )
Substitua <config> pela configuração da instância do banco de dados federado.
Se a configuração for válida, o comando retornará a seguinte resposta:
{ "ok" : 1 }
Se a configuração for inválida, o comando retorna a lista de erros no campo errs :
{ "ok" : 1, "errs" : [ "<error>", "<error>", ... ] }
Atualize sua configuração da instância do banco de dados federado
Para atualizar a configuração da instância do banco de dados federado , conecte-se à instância e use o seguinte comando:
use admin db.runCommand( { "storageSetConfig" : <config> } )
Substitua <config> pela configuração da instância do banco de dados federado.
Dica
O MongoDB recomenda que você valide sua configuração de instância do banco de dados federado antes de aplicar quaisquer alterações.
Para atualizar os armazenamentos de dados, fontes de dados, bancos de dados, coleções e visualizações da Instância do Banco de Dados Federado, siga estas etapas:
Faça suas alterações na configuração de armazenamento da instância do banco de dados federado .
Gerenciar fontes de dados
Adicionar mais uma fonte de dados
Corresponde à configuração JSON do stores.
Clique em Add Data Store Sources.
Selecione o provedor de fonte de dados que você deseja configurar: - Para AWS S3, continue para a etapa 5 de Implantar um armazenar de instância do banco de dados federado. - Para o Google Cloud, continue para a etapa 7 de Implantar uma instância do banco de dados federado de armazenamento de dados. - Para Azure, continue para a etapa 7 de implantar um Armazenamento de Dados de Instância do Banco de Dados Federado. - Para o cluster Atlas, continue para a etapa 7 de Implantar uma instância do banco de dados federado. - Para armazenamento de dados HTTP, continue para a etapa 7 de Implantar um armazenamento de dados de instância do banco de dados federado. - Para Atlas Online Archive, continue para a etapa 7 de Implantar uma instância do banco de dados federado de armazenamento de dados.
Editar seu nome de fonte de dados
Corresponde à configuração JSON do stores.[n].name.
Selecione sua fonte de armazenamento de dados na lista à esquerda.
Clique no ícone Editar nome da loja .
Altere o nome atual no campo Nome do armazenar de dados.
Clique em Concluído.
Excluir uma fonte de dados
Selecione sua fonte de armazenamento de dados na lista à esquerda
Clique no ícone Excluir esta loja
Clique no botão Excluir.
Gerenciar bancos de dados
Criar um novo banco de dados
Corresponde à configuração JSON do databases.
Clique no botão Adicionar banco de dados no canto superior direito
Preencha o campo Nome do banco de dados
Preencha o campo Nome da coleção
Clique no botão Criar
Editar um nome de banco de dados
Corresponde à configuração JSON do databases.[n].name.
Selecione seu Banco de dados na lista.
Clique no ícone Editar nome do banco de dados .
Atualize o nome do banco de dados.
Clique no botão Concluído.
Excluir um banco de dados
Selecione seu Banco de dados na lista.
Clique no ícone Excluir este banco de dados .
Clique no botão Excluir.
Gerencie coleções
Criar uma nova coleção em um banco de dados
Corresponde à configuração JSON do databases.[n].collections.
Selecione o banco de dados de onde você deseja criar uma coleção
Clique no ícone Adicionar coleção
Preencha o campo Nome da coleção
Clique no botão Criar
Editar um nome de coleção
Corresponde à configuração JSON do databases.[n].collections.[n].name.
Selecione sua Coleção na lista
Clique no ícone Editar nome da coleção
Altere o nome atual no campo Nome da coleção para o seu novo nome
Clique no botão Criar
Excluir uma coleção
Selecione sua Coleção na lista
Clique no ícone Excluir esta coleção
Clique no botão Excluir.
Gerenciar visualizações
Criar uma nova visualização em uma coleção
Corresponde à configuração JSON do databases.[n].views.
Selecione a coleção a partir da qual deseja criar uma Visualização
Clique no ícone Adicionar Visualização
Preencha o campo Nome da visualização
Preencha o campo :manual:`Pipeline tributado em direito
Clique no botão Criar
Editar um nome de visualização ou pipeline
Corresponde às definições de configuração JSON do databases.[n].views.[n].name e databases.[n].views.[n].pipeline , respectivamente.
Selecione sua visualização na sua coleção
Clique no ícone Editar Nome da Visualização
Altere o nome atual no campo Visualizar nome para o seu novo nome
Altere o pipeline atual no campo Pipeline para o novo pipeline
Clique no botão Salvar
Excluir uma visualização
Selecione sua visualização na lista
Clique no ícone Excluir esta visualização
Clique no botão Excluir.
Edite os objetos do arquivo de configuração JSON para adicionar, criar ou remover stores, databases ou views
Para saber mais sobre as definições de configuração do seu provedor específico de Armazenamento de Dados, consulte a página arquivo de configuração:
Para saber como definir e gerenciar a configuração de armazenamento usando MongoDB Shell (mongosh), consulte a página Gerenciar uma instância do banco de dados federado.
Gerar coleções curinga
Importante
A função de coleções curinga está disponível somente para fontes de dados da AWS S3 e clusters Atlas.
Ao utilizar fontes de dados do AWS S3 ou Atlas Clusters, você pode definir dinamicamente os nomes de coleções que mapeiam os dados. Para gerar um nome de coleção, especifique o símbolo curinga * como o valor da configuração do nome da coleção na configuração de armazenamento da instância do banco de dados federado.
Dica
Você pode utilizar o comando storageSetConfig para definir as configurações para gerar coleções curinga (*).