Página inicial do Docs → Iniciar e gerenciar o MongoDB → MongoDB Atlas
Gerenciar arquivos online
Nesta página
- Acesso obrigatório
- Ver Online Archive
- Recuperar um Online Archive Utilizando o Atlas CLI
- Recuperar um Online Archive usando a API
- Recuperar todos os Online Archives de um cluster usando a API
- Visualizar Online Archives na IU
- Exibir métricas de Online Archives
- Navegue até a página Database Deployments do seu projeto.
- Selecione Data Federation em Services na navegação à esquerda.
- Edite uma regra de arquivamento
- Editar uma Regra de Arquivamento Através da Atlas CLI
- Editar uma regra de arquivamento por meio da API
- Editar uma regra de arquivamento por meio da interface do usuário
- Editar a partição no Cloud Object Store
- Query Online Archive
- Connection string
- Considerações de desempenho
- Preço da query
- Excluir um Online Archive
- Exclua um Online Archive do Atlas por meio da Atlas CLI
- Excluir um Online Archive da interface do usuário
- Excluir um Online Archive por meio da API
Importante
Recurso Indisponível em Instâncias sem Servidor
Neste momento, as instâncias sem servidor não permitem essa funcionalidade. Para saber mais, consulte Limitações de instância sem servidor.
Depois de configurar um Online Archive, você pode fazer o seguinte:
Veja seu arquivo on-line
Editar seu Online Archive
Consulte seu Online Archive
Exclua seu Online Archive
Acesso obrigatório
Para visualizar ou executar query em um Online Archive, você deve ter acesso Project Read Only ou superior ao projeto.
Para editar ou excluir um Online Archive, você deve ter acesso ao Project Data Access Admin ou superior ao projeto.
Ver Online Archive
Importante
Recurso Indisponível em Instâncias sem Servidor
Neste momento, as instâncias sem servidor não permitem essa funcionalidade. Para saber mais, consulte Limitações de instância sem servidor.
Você pode exibir a lista de arquivos online de um cluster por meio da Atlas CLI, da interface do usuário do Atlas e daAPI .
Recuperar um Online Archive Utilizando o Atlas CLI
Para listar todos os arquivos online para um cluster utilizando o Atlas CLI, execute o seguinte comando:
atlas clusters onlineArchives list [options]
Para retornar os detalhes do Online Archive que você especificar utilizando a Atlas CLI, execute o seguinte comando:
atlas clusters onlineArchives describe <archiveId> [options]
Para saber mais sobre a sintaxe e parâmetros para os comandos anteriores, consulte a documentação do Atlas CLI para atlas clusters onlineArchives list e atlas clusters onlineArchives describe.
Dica
Veja: links relacionados
Recuperar um Online Archive usando a API
Para recuperar um Online Archive por meio da API, envie uma solicitação de GET para o endpoint onlineArchives com a ID exclusiva do Online Archive a ser recuperado. Para saber mais sobre a sintaxe e as opções da API , consulte API.
Recuperar todos os Online Archives de um cluster usando a API
Para recuperar todos os arquivos online configurados para um cluster utilizando a API, envie uma solicitação do GET para o endpoint onlineArchives para o cluster. Para saber mais sobre a sintaxe e as opções, consulte API.
Visualizar Online Archives na IU
Para ver a lista de Online Archives:
Navegue até a página Database Deployments do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se a página Database Deployments ainda não estiver exibida, clique em Database na barra lateral.
Navegue até a guia Online Archive para seu cluster.
Clique no nome do cluster.
Clique na aba Online Archive para visualizar a lista de arquivos online, se houver, para o cluster.
A página exibe os arquivos online do cluster. Para cada Online Archive, você pode ver as seguintes informações:
Observação
Os valores das novas métricas disponíveis com o lançamento em 7 de Junho de 2023 são exibidos na interface do usuário do Atlas somente para arquivos online criados após o lançamento. Para arquivos online preexistentes, o Atlas exibe N/A em vez do valor da métrica.
Nome da coluna | Descrição | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | Status do Online Archive. O valor pode ser um dos seguintes:
| ||||||||||||||||
Actions | Operações que você pode executar no Online
Archive. | ||||||||||||||||
Archive Field | Campo Data com base em quais documentos são arquivados. | ||||||||||||||||
Custom Criteria | Filtro JSON personalizado. Você pode rolar neste componente de código. Clique no ícone para expandir a exibição e ver os critérios personalizados completos. | ||||||||||||||||
Age Limit | Número de dias usados para qualificar documentos para arquivamento. | ||||||||||||||||
Deletion Age Limit | Número de dias após os quais excluir os dados no arquivo. | ||||||||||||||||
Total Data Archived | Tamanho dos dados não compactados armazenados no arquivo. Passe o mouse para ver o número de documentos no arquivo. Métrica disponível apenas para novos Arquivos Online no Atlas Data Lake. | ||||||||||||||||
Last Archived Run | Data de início e hora em que o arquivo foi executado pela última vez. Passe o mouse para ver os últimos cinco tarefas. Cada tarefa aparece listada com sua data de início, hora de início, duração do tempo de arquivamento, número de documentos e tamanho. | ||||||||||||||||
Partition Fields | Outros campos de query comumente usados para particionamento de dados no armazenamento de objetos na nuvem. | ||||||||||||||||
Schedule | Cadência da janela de arquivamento. Os valores incluem: - Monthy on <Day_Number> - Weekly on <Day_Name> - Daily Passe o mouse para ver a próxima janela de arquivamento. | ||||||||||||||||
Min Date Field | Valor mínimo da data de todos os documentos no arquivo. Métrica disponível somente para novos Online Archives no Atlas Data Lake. | ||||||||||||||||
Max Date Field | Valor máximo de data de todos os documentos no arquivo. Métrica disponível somente para novos Arquivos Online no Atlas Data Lake. |
Exibir métricas de Online Archives
Para visualizar as métricas dos Online Archives na interface do usuário do Atlas:
Navegue até a página Database Deployments do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se a página Database Deployments ainda não estiver exibida, clique em Database na barra lateral.
Selecione Data Federation em Services na navegação à esquerda.
A página exibe as seguintes métricas para cada instância do banco de dados federado na seção Online Archive Federated Database Instances:
Queries executadas / Mês | Número de queries executadas (cumulativo) no mês atual. O Atlas atualiza este valor a cada 5 minutos. |
|---|---|
Dados processados / Mês | Quantidade de dados processados no mês calendário atual. Atlas atualiza esse valor a cada 5 minutos. |
Dados devolvidos / Mês | Quantidade de dados retornados no mês do calendário atual. O Atlas atualiza este valor a cada 5 minutos. |
Última execução de arquivo | Data e hora em que o Atlas executou pela última vez o trabalho de arquivamento de dados. |
Edite uma regra de arquivamento
Importante
Recurso Indisponível em Instâncias sem Servidor
Neste momento, as instâncias sem servidor não permitem essa funcionalidade. Para saber mais, consulte Limitações de instância sem servidor.
Você pode modificar o número de dias para manter os dados no Atlas cluster (o Age Limit) ou a query personalizada JSON utilizada para selecionar documentos para arquivamento a partir da UI do Atlas e API. Você não pode alterar os critérios de arquivamento de Date Match para Custom Filter ou vice-versa.
Editar uma Regra de Arquivamento Através da Atlas CLI
Para atualizar um Online Archive para um cluster utilizando o Atlas CLI, execute o seguinte comando:
atlas clusters onlineArchives update <archiveId> [options]
Para saber mais sobre a sintaxe de comando e parâmetros, consulte a documentação do Atlas CLI para atlas clusters onlineArchives update.
Dica
Veja: links relacionados
Editar uma regra de arquivamento por meio da API
Para editar um Online Archive por meio da API, envie uma solicitação do PATCH para o endpoint onlineArchives com o ID exclusivo do Online Archive para atualizar. Para saber mais sobre a sintaxe e as opções da API , consulte API.
Editar uma regra de arquivamento por meio da interface do usuário
Para editar um Online Archive, na interface de usuário do Atlas:
Navegue até a página Database Deployments do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se a página Database Deployments ainda não estiver exibida, clique em Database na barra lateral.
Navegue até a guia Online Archive para seu cluster.
Clique no nome do cluster.
Clique na aba Online Archive para visualizar a lista de arquivos online, se houver, para o cluster.
Clique nas reticências (...) na coluna Actions do arquivo online para exibir a lista de ações permitidas.
Você pode:
Pause Archiving (somente se o estado for Active)
Edit Archive
Delete Archive
Resume Archiving (somente se o estado for Paused)
Selecione Edit Archive no menu suspenso para fazer alterações em sua regra de arquivamento, no número de dias para manter os dados arquivados e na janela de tempo para executar trabalhos de arquivamento de dados.
Você pode alterar os critérios de arquivamento e o número de dias após os quais excluir os dados arquivados.
Para editar Date Match critérios, modifique o número de dias em que o Atlas cluster armazena dados no Atlas cluster ativo na seção Archival Age Limit.
Para editar Custom Criteria, insira um filtro JSON válido para selecionar os documentos para arquivamento.
Observação
O Atlas utiliza a query especificada com o comando db.collection.find(query) . As queries personalizadas não suportam expressões JavaScript. Além disso, você não pode passar um documento vazio
{}para devolver todos os documentos.Para modificar o número de dias após os quais o Atlas exclui dados arquivados, insira ou modifique o número de dias na seção Deletion Age Limit. Você pode especificar entre
7e9125dias ou deixar o campo vazio para desabilitar a regra de expiração de dados. Demora 24 horas para que esta alteração entre em vigor.Para modificar o horário agendado para tarefas de arquivamento de dados, faça alterações em qualquer um dos seguintes:
Frequência. Você pode optar por executar a tarefa todos os dias, em um dia específico da semana ou em uma data específica a cada mês. Se você deseja arquivar no dia , ou de cada mês, o Atlas não executa o trabalho de arquivamento para os meses que não incluem estas datas.
Janela de tempo. Selecione o período de tempo durante o qual você deseja que o Atlas execute o trabalho de arquivamento de dados. Você deve especificar um mínimo de duas horas.
Você também pode desabilitar a programação alternando Schedule Archive Window. Se você desabilitar a programação, o Atlas reverterá para a programação padrão e executará o trabalho de arquivamento periodicamente.
O Atlas começa a usar o novo cronograma de arquivamento de dados imediatamente após você alterá-lo. No entanto, se um trabalho de arquivamento estiver atualmente em execução, o Atlas não interromperá o trabalho em execução e a configuração entrará em vigor após a conclusão do trabalho.
Clique em Save para que as alterações entrem em vigor.
Observação
Demora 24 horas para que as alterações de Deletion Age Limit entrem em vigor.
Editar a partição no Cloud Object Store
Você não pode modificar os campos ou a estrutura da partição a partir da interface do usuário ou da API do Atlas. No entanto, você pode migrar manualmente os dados do armazenamento de objetos na nuvem usando mongodump, excluir o arquivamento online, usar mongorestore para restaurar os dados no Atlas cluster e, em seguida, criar um novo Online Archive para a coleção com a partição desejada campos e estrutura.
Query Online Archive
Você pode executar queries em relação aos dados arquivados.
Observação
O Atlas Data Federation usa armazenamento colunar que não preserva a ordem dos campos nos documentos. Portanto, o Atlas Data Federation não suporta queries que são sensíveis de ordem de campo contra seus dados arquivados.
Connection string
Para executar consultas, você deve primeiro conectar-se ao Online Archive. A cadeia de conexão do cluster do Atlas permite que você só execute consultas de dados no cluster do Atlas. Para executar consultas do Online Archive, você deve usar um dos seguintes:
Conecte-se ao Online Archive e ao Cluster - essa cadeia de conexão somente leitura permite que você leia dados diretamente do cluster ativo. Isso afeta os recursos disponíveis para IOPS e do Online Archive.
Conecte-se ao Online Archive - essa cadeia de conexão somente para leitura permite que você leia dados somente do Online Archive e não afeta os recursos do cluster.
Considerações de desempenho
Em geral, suas consultas em dados arquivados são muito mais lentas do que suas consultas em dados do cluster do Atlas. Quando você consulta dados no cluster e no Online Archive por meio da cadeia de conexão federada:
Queries de bloqueio, como classificações que consomem e processam todos os documentos de entrada na operação de classificação antes de retornar resultados, têm características de desempenho associadas ao armazenamento mais lento, o arquivamento, que está sendo consultado. As operações de classificação exigem que todos os dados das fontes estejam sendo consultados antes de retornar os resultados.
As queries de streaming, como as descobertas, têm características de desempenho associadas ao armazenamento de melhor desempenho, o Atlas cluster, que está sendo consultado. O Atlas retorna os resultados assim que eles estão disponíveis, o que significa que a devolução dos resultados do arquivamento demora mais do que a devolução dos resultados do Atlas cluster.
Preço da query
Para suas queries federadas e somente para arquivamento, você incorre em custos com os seguintes itens.
Digitalização de dados
Durante a varredura de dados, o Atlas processa dados do cluster e do arquivo. O Atlas executa o máximo possível da query no cluster para minimizar a quantidade de dados que precisa verificar. Por exemplo, para uma query do match que especifica um valor específico, o Atlas recupera somente documentos com o valor especificado do cluster. Em seguida, o Atlas combina os documentos recuperados com os dados arquivados e retornos.
Para bloquear queries que precisam acessar todos os dados armazenados no cluster subjacente, o Atlas recupera todos os dados. Por exemplo, para um sort (sem match), o Atlas recupera todos os dados do cluster e arquivo para ser classificado.
Acesso aos dados
MongoDB cobra uma taxa para cada partição query no arquivo. Se sua query exigir a query de partições específicas, o MongoDB fará o download das partições e cada partição baixada corresponderá a um único acesso.
Busca de dados
Para localizar partições com base nos campos de query e query, o Atlas executa operações no arquivo. Cada operação executada pelo Atlas encontra até 1000 partições. O Atlas executa o número mínimo de operações necessárias para localizar as partições necessárias para satisfazer a query. Por exemplo, se a query exigir 100 partições cobertas nos campos de query, o Atlas executará apenas uma operação para satisfazer a query.
transferência de dados
Os dados transferidos para a infraestrutura federada incorrem em custos de transferência de dados.
Excluir um Online Archive
Importante
Recurso Indisponível em Instâncias sem Servidor
Neste momento, as instâncias sem servidor não permitem essa funcionalidade. Para saber mais, consulte Limitações de instância sem servidor.
Você pode excluir um Online Archive pela interface do usuário do Atlas e API. Quando você remove um Online Archive, o Atlas exclui todos os arquivos e metadados no armazenamento de Online Archive após um período de cinco dias. Depois de excluir esses dados, você não poderá restaurá-los.
Se você descartar um database ou uma coleção configurada para arquivamento online, os dados da coleção, se arquivados, continuarão disponíveis no armazenamento de objetos na nuvem. Você incorre em custos de armazenamento no armazenamento de objetos na nuvem. Alternativamente, se você excluir o cluster, o Atlas excluirá todos os arquivos online configurados para o cluster. Isso também exclui quaisquer dados arquivados do armazenamento de objetos na nuvem.
Se você excluir todos os arquivos online, você também excluirá a instância do banco de dados federado e criará uma nova instância do banco de dados federado quando você criar um Online Archive novamente.
Depois de excluir um Online Archive, seu estado passa para Deleted. Você pode criar outro Online Archive para o mesmo banco de dados, coleção e campos que o Online Archive excluído se não houver outro Online Archive para o mesmo banco de dados, coleção e campos no estado Active.
Exclua um Online Archive do Atlas por meio da Atlas CLI
Para excluir um Online Archive para um cluster utilizando o Atlas CLI, execute o seguinte comando:
atlas clusters onlineArchives delete <archiveId> [options]
Para saber mais sobre a sintaxe de comando e parâmetros, consulte a documentação da Atlas CLI para atlas clusters onlineArchives delete.
Dica
Veja: links relacionados
Excluir um Online Archive da interface do usuário
Para excluir um Online Archive, em sua interface de usuário do Atlas:
Navegue até a página Database Deployments do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se a página Database Deployments ainda não estiver exibida, clique em Database na barra lateral.
Navegue até a guia Online Archive para seu cluster.
Clique no nome do cluster.
Clique na aba Online Archive para visualizar a lista de arquivos online, se houver, para o cluster.
Clique nas reticências (...) na coluna Actions do arquivo online para exibir a lista de ações permitidas.
Você pode:
Pause Archiving (somente se o estado for Active)
Edit Archive
Delete Archive
Resume Archiving (somente se o estado for Paused)
Selecione Delete Archive no menu de reticências para exibir a janela de confirmação Delete Online Archive .
Digite o nome do Online Archive a ser excluído e clique em Delete.
Excluir um Online Archive por meio da API
Para excluir um Online Archive por meio da API, envie uma solicitação de DELETE para o endpoint onlineArchives com a ID exclusiva do Online Archive a ser excluído. Para saber mais sobre a sintaxe e as opções, consulte API.