Tutorial: Alterar a camada de armazenamento de conjuntos de dados sísmicos

Use a operação Alterar Camada do DDMS Seismic no Gerenciador de Dados para Energia do Azure para mover conjuntos de dados entre as camadas de armazenamento Quente, Fria e Fria, com base na frequência de acesso. Mover dados raramente acessados para camadas mais frias reduz os custos de armazenamento, enquanto manter conjuntos de dados ativos na camada Hot garante o desempenho ideal. Essa operação é especialmente valiosa para o gerenciamento de dados sísmicos, em que grandes volumes de dados históricos devem permanecer disponíveis para análise ou conformidade futuras, mas não exigem acesso frequente.

Neste tutorial, você aprenderá como:

Entender as camadas de armazenamento

Seismic DDMS suporta as seguintes camadas de armazenamento, que são mapeadas para as classes de armazenamento do provedor de nuvem subjacente.

Cada camada tem um período mínimo de retenção. Mover dados de uma determinada camada antes que o período mínimo de retenção seja concluído pode incorrer em taxas de exclusão antecipada.

Pré-requisitos

Antes de iniciar, verifique se você cumpre os seguintes pré-requisitos:

• Um recurso do Azure Data Manager for Energy com o Seismic DDMS configurado.
• Um tenant e um subproject registrados no serviço Seismic DDMS.
• A função subproject.admin atribuída à sua conta de usuário.
• Um token de portador para autenticação da API. Veja como gerar o token de autenticação.
• Pelo menos um conjunto de dados registrado no subprojeto de destino.

Iniciar uma operação de alteração de nível

Antes de enviar a solicitação, pause todas as operações de gravação e exclusão no caminho de destino. Adicionar ou excluir conjuntos de dados enquanto uma operação de camada de alteração está em andamento pode levar a resultados inconsistentes.

1. Envie uma solicitação PUT com o caminho e a camada de destino. Use uma barra final / para os caminhos de diretório (por exemplo, sd://tenant/subproject/a/b/c/) e nenhuma barra final para um único conjunto de dados (por exemplo, sd://tenant/subproject/a/b/c/dataset-name):

   • Todos os conjuntos de dados em um caminho:

     PUT <instance>.energy.azure.com/seistore-svc/api/v3/operation/change-tier?path=sd://{tenant}/{subproject}/{path}/&tier=Cool
     Authorization: Bearer {access_token}
     Content-Type: application/json
     

   • Conjunto de dados único:

     PUT <instance>.energy.azure.com/seistore-svc/api/v3/operation/change-tier?path=sd://{tenant}/{subproject}/{path}/{dataset_name}&tier=Cool
     Authorization: Bearer {access_token}
     Content-Type: application/json
     

2. Salve o operation_id da resposta 202 Accepted. Você precisa dela para monitorar a operação.

   {
     "operation_id": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c"
   }
   

Monitorar o status da operação

Depois de iniciar a operação de mudança de nível, consulte o endpoint de status para acompanhar o progresso.

1. Consulte o ponto de extremidade de status com o operation_id até que status seja Completed ou Failed:

   GET <instance>.energy.azure.com/seistore-svc/api/v3/operation/change-tier/{operation_id}
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Verifique o status campo na resposta. Enquanto a operação está em execução:

   {
     "operation_id": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c",
     "created_at": "2026-03-10T06:15:00Z",
     "created_by": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
     "last_updated_at": "2026-03-10T06:17:30Z",
     "status": "Running",
     "dataset_cnt": 500,
     "completed_cnt": 342,
     "failed_cnt": 0,
     "target_tier": "Cool"
   }
   

   Quando a operação for concluída, status será alterada para Completed. Verifique failed_cnt se há falhas parciais:

   {
     "operation_id": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c",
     "created_at": "2026-03-10T06:15:00Z",
     "created_by": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
     "last_updated_at": "2026-03-10T06:25:00Z",
     "status": "Completed",
     "dataset_cnt": 500,
     "completed_cnt": 497,
     "failed_cnt": 3,
     "target_tier": "Cool"
   }
   

Recuperar detalhes da falha

Use o show_details=true parâmetro para obter informações de erro por conjunto de dados para quaisquer conjuntos de dados que falham durante a alteração de camada.

1. Adicione show_details=true à solicitação de status:

   GET <instance>.energy.azure.com/seistore-svc/api/v3/operation/change-tier/{operation_id}?show_details=true&limit=100
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Os seguintes parâmetros de consulta controlam a resposta:

   Parâmetro	Obrigatório	Tipo	Descrição
   show_details	No	booleano	Defina true para incluir o failed_datasets array na resposta. Padrão: false.
   limit	No	inteiro (1 a 1000)	Número máximo de conjuntos de dados com falha a serem retornados por página. Padrão: 100. Aplicável somente quando show_details=true.
   cursor	No	cadeia	Cursor codificado em Base64 seguro para URL de uma resposta anterior para recuperar a próxima página de falhas.

2. Examine a failed_datasets matriz na resposta:

   {
     "operation_id": "c3d282e6-e7d1-40d8-8ac2-edc15b6d174c",
     "created_at": "2026-03-10T08:00:00Z",
     "created_by": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
     "last_updated_at": "2026-03-10T08:45:00Z",
     "status": "CompletedWithErrors",
     "dataset_cnt": 2000,
     "completed_cnt": 1994,
     "failed_cnt": 6,
     "target_tier": "Cold",
     "failed_datasets": [
       {
         "sdpath": "sd://opendes/project-alpha/seismic/survey-2024-001",
         "error": "Failed to change tier for 12 blob(s)"
       },
       {
         "sdpath": "sd://opendes/project-alpha/seismic/survey-2024-002",
         "error": "Access denied: user is not authorized to modify this dataset (ACL validation failed)"
       },
       {
         "sdpath": "sd://opendes/project-alpha/seismic/survey-2024-003",
         "error": "Failed to acquire lock"
       },
       {
         "sdpath": "sd://opendes/project-alpha/seismic/survey-2024-004",
         "error": "Dataset has no associated storage location"
       },
       {
         "sdpath": "sd://opendes/project-alpha/seismic/survey-2024-005",
         "error": "Dataset storage location has invalid format"
       },
       {
         "sdpath": "sd://opendes/project-alpha/seismic/survey-2024-006",
         "error": "Tier changed but metadata update failed after retries"
       }
     ],
     "cursor": "ZXlKamIyNTBhVzUxWVhScGIyNVViMnRsYmlJNkltVjRZVzF3YkdVaWZRPT0"
   }
   

   Se a resposta incluir um valor cursor, passe-o na próxima solicitação para obter a próxima página de falhas.

Políticas de retenção da camada de armazenamento

Cada camada de armazenamento impõe um período mínimo de retenção. Se você mover dados de uma camada mais fria para uma camada mais quente antes do período de retenção expirar, as taxas de exclusão antecipada poderão ser aplicadas.

Siga estas práticas ao gerenciar alterações na camada de armazenamento:

• Auditar antes de alterar as camadas — use a API de lista de conjuntos de dados para identificar quais conjuntos de dados são candidatos a alterações de camada antes de iniciar uma operação em massa.
• Respeite os períodos de retenção — Mover dados para fora das camadas Esporádico antes do período mínimo de retenção incorre em cobranças por exclusão antecipada.
• Monitorar operações até a conclusão — sempre verificar o status da operação até que status seja Completed ou Failed. Não suponha êxito após a 202 Accepted resposta.
• Lidar com falhas de forma tranquila — use show_details=true para recuperar informações de erro por conjunto de dados e solucionar causas raiz (permissões, blobs ausentes, violações de retenção) antes de tentar novamente.
• Planeje para alterações na latência de acesso — Conjuntos de dados nas camadas Esporádico podem ter latência do primeiro byte maior. Verifique se os consumidores downstream estão cientes de possíveis aumentos de latência.

Limpar os recursos

Não há recursos de Azure faturáveis criados neste tutorial. Se você alterou as camadas de armazenamento para fins de teste, restaure-as executando outra operação de camada de alteração.

Conteúdo relacionado

• Tutorial: Trabalhar com dados sísmicos usando APIs do DDMS sísmico
• Visão geral das camadas de acesso do Armazenamento de Blobs do Azure
• Armazenamento de Blobs do Azure políticas de gerenciamento do ciclo de vida
• os preços do Armazenamento de Blobs do Azure
• Referência da API do Seismic DDMS