Gerenciar arquivos online
Nesta página
- Acesso necessá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
- No Atlas, acesse sua instância de banco de dados federado para seu projeto.
- Revise as métricas.
- 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âncias sem servidor.
Depois de configurar um Online Archive, você pode fazer o seguinte:
Visualizar seu Online Archive
Editar seu Online Archive
Consulte seu Online Archive
Exclua seu Online Archive
Acesso necessá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 os parâmetros dos comandos anteriores, consulte a documentação da Atlas CLI para clusters do Atlas onlineArchives list e clusters do Atlas onlineArchives describe.
Recuperar um Online Archive usando a API
Para recuperar um Atlas Online Archive por meio da API, envie uma solicitação de GET para o endpoint onlineArchives com a ID exclusiva do Atlas 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:
No Atlas, VáGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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 ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Go Acesse a Online Archive página do seu cluster.
Clique no nome do seu cluster.
Clique na aba Online Archive.
A página Online Archive é exibida.
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 em Date Match campo. Se você criar um Online Archive de séries temporais ou tiver um Online Archive preexistente após a data de lançamento, o Atlas exibirá N/A em vez do valor da métrica.
Nome da coluna | Descrição | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | Status do arquivo online. 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. | ||||||||||||||
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: - | ||||||||||||||
Min Date Field | Valor mínimo da data de todos os documentos no arquivo. Métrica disponível apenas para novos Arquivos Online no Atlas Data Federation. | ||||||||||||||
Max Date Field | Valor máximo de data de todos os documentos no arquivo. Métrica disponível apenas para novos Arquivos Online no Atlas Data Federation. |
Exibir métricas de Online Archives
Para visualizar as métricas dos Online Archives na interface do usuário do Atlas:
No Atlas, acesse sua instância de banco de dados federado para seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.
Na barra lateral, clique em Data Federation sob o título Services.
A página Data Federation é exibida.
Revise as métricas.
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 da Atlas CLI para clusters do Atlas onlineArchives update.
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 de 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:
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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 ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Go Acesse a Online Archive página do seu cluster.
Clique no nome do seu cluster.
Clique na aba Online Archive.
A página Online Archive é exibida.
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.coleção.find(query). As queries personalizadas não suportam expressões JavaScript. Além disso, não é possível 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.
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 objeto na nuvem usando $merge, use $merge para reidratar dados de volta ao Atlas cluster, excluir o arquivamento online e, em seguida, criar um novo arquivamento online para a coleção com os campos de partição desejados 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 por meio da Atlas CLI, Atlas UI e API. Quando você remove um Online Archive, o Atlas exclui todos os arquivos e metadados no armazenamento de arquivos online após um período de cinco dias. Depois de excluir esses dados, você não poderá restaurá-los.
Se você descartar um banco de dados 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 clusters do Atlas onlineArchives delete.
Excluir um Online Archive da interface do usuário
Para excluir um Online Archive, em sua interface de usuário do Atlas:
No Atlas, váGo para a Clusters página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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 ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Go Acesse a Online Archive página do seu cluster.
Clique no nome do seu cluster.
Clique na aba Online Archive.
A página Online Archive é exibida.
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)
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.