Skip To Content

Comandos de REST do ArcGIS Data Store

Quando você configura o ArcGIS Data Store, você associa ele com o site do GIS Server que servirá como seu servidor de hospedagem do portal do ArcGIS Enterprise. As ações que alteram ou verificam o status do armazenamento de dados são executadas a partir do ArcGIS Server Administrator Directory para o servidor de hospedagem como administrador do ArcGIS Server. (O formato da URL é https://gisserver.domain.com:6443/arcgis/admin.) Você também pode remover uma máquina em espera de um armazenamento de dados relacional em execução no modo primário-auxiliar e remover a máquina auxiliar do site GIS Server no Administrator Directory do ArcGIS Server. As seguintes seções resumem estas operações e vinculam à documentação do ArcGIS API.

Se você não for o administrador do ArcGIS Server do servidor de hospedagem, precisará trabalhar com essa pessoa para concluir as tarefas descritas aqui.

Os seguintes são os caminhos no ArcGIS Server Administrator Directory que você precisa seguir para acessar operações para cada tipo de armazenamento de dados:

  • Armazenamento de dados relacional—Clique em dados > itens > enterpriseDatabases > <nome do armazenamento de dados> > máquinas > <nome da máquina>.
  • Armazenamento de grandes dados de espaço-tempo—Clique em dados > itens > nosqlDatabases > AGSDataStore_bigdata_<nome do armazenamento de dados> > máquinas > <nome da máquina>.
  • Armazenamento de dados—Clique em dados > itens > nosqlDatabases > AGSDataStore_graph_<data store name> > machines > <machine name>.
  • Armazenamento de objeto—Clique em dados > itens > objectStores > <nome do armazenamento de dados> > máquinas > <nome da máquina>.

Alterar o status de uma máquina do armazenamento de dados

Você pode parar e reiniciar máquinas individuais no armazenamento de dados. Você também pode promover uma máquina de armazenamento de dados relacional auxiliar para ser a máquina primária.

Parar a máquina primária do armazenamento de dados não causa falha no armazenamento de dados em uma implantação local, já que você não deseja falhar se você estiver executando uma tarefa de manutenção, tal como tornar seu armazenamento de dados offline temporariamente.

Por exemplo, você altera o status da máquina do armazenamento de dados como parte do seguinte cenário de atualização:

  • Pare a máquina auxiliar.
  • Atualize a auxiliar.
  • Inicie a auxiliar.
  • Promova a máquina auxiliar para primária usando o comando makePrimary.
  • Pare a máquina primária antiga.
  • Atualize a primária antiga.
  • Inicie a primária antiga.
  • Adicione a máquina primária antiga de volta no armazenamento de dados como a máquina auxiliar.

Entre no ArcGIS Server Administrator Directory do servidor de hospedagem como o administrador de site do ArcGIS Server e siga para uma máquina específica para utilizar quaisquer dos seguintes comandos para alterar o status de uma máquina do armazenamento de dados:

  • stop
  • start
  • makePrimary (máquinas auxiliares em um armazenamento de dados relacional)

Validar o armazenamento de dados

Você pode verificar o status das máquinas em um armazenamento de dados usando o comando REST validate do ArcGIS Server.

Entre no ArcGIS Server Administrator Directory para o servidor de hospedagem como o administrador do site do ArcGIS Server, vá até uma das máquinas no tipo de armazenamento de dados específico que deseja verificar e clique em validar para ver as informações relacionadas deste armazenamento de dados. Informações importantes relacionadas a um status do armazenamento de dados inclui o seguinte:

  • overallhealth—Os valores são os seguintes:
    • Healthy—Todos os componentes em todas as máquinas membros estão acessíveis e funcionando.
    • HealthyWithWarning—Esse estado se aplica apenas a armazenamentos de objetos dados relacionais e gráficos. Um ou mais componentes não estão disponíveis, mas o armazenamento de dados ainda pode ser usado. Este valor é retornado para o armazenamento de dados relacional quando a máquina primária está íntegra, mas a máquina auxiliar não está disponível. O armazenamento de dados relacionais não está altamente disponível neste momento. Para armazenamentos de objetos ou armazenamentos de gráficos executados no modo de aggrupamento, o armazenamento de dados pode não estar altamente disponível.
    • Unhealthy—Um armazenamento de dados é considerado não íntegro se mais da metade das máquinas nele estiverem inacessíveis ("datastore.overallhealth": "Unhealthy"). Uma máquina é considerada ruim se ela estiver inacessível ("machine.overallhealth": "Ruim").
  • status—Para armazenamentos de dados relacionais, os valores possíveis são Iniciado ou Parado. Quando parado, você não pode publicar camadas de feição hospedadas ou camadas de cena hospedadas para seu portal.
  • clusterStatus—Para armazenamentos de grandes dados de espaço-tempo, os status são como seguem:
    • green—Todos os dados estão disponíveis.
    • amarelo—Os dados estão disponíveis, mas alguns ou todas as cópias de réplica dos dados não estão disponíveis e seu armazenamento de dados spatiotemporal big não está atualmente disponível. Você sempre visualizará este status se você configurou um armazenamento de dados spatiotemporal big de única máquina. Você pode também visualizar este status se as máquinas estiverem rebalanceando dados, uma ou mais máquinas em seu armazenamento de dados spatiotemporal big são inacessíveis. Se você tiver um armazenamento de dados spatiotemporal big de múltiplas máquinas e visualizar um status amarelo, confirme que todas as máquinas ainda estão disponíveis validando cada máquina. Se elas estiverem disponíveis, espere algumas horas e verifique novamente. Se o status ainda estiver amarelo, examine os logs do ArcGIS Server para encontrar erros.
    • vermelho—Alguns ou todos os dados estão inacessível. Examine os logs e corrija os erros.
  • papel—Para máquinas em um armazenamento de dados relacional, isso indica se a máquina é a máquina primária ou auxiliar. Para o armazenamento de objetos e o armazenamento de gráficos, o papel será primário para uma única instância, e cluster_member quando implantado no modo de agrupamento.
  • mensagens—Você verá o aviso e mensagens de erros relacionados ao status do armazenamento de dados aqui.

Você pode usar a validação para o seguinte:

  • Confirme se uma máquina de armazenamento de dados foi parada ou iniciada.
  • Confirme se o comando makePrimary promoveu a máquina auxiliar para a máquina primária.
  • Como uma etapa inicial de solução de problemas se as camadas de cena ou feição hospedadas não puderem ser publicadas ou acessadas, ou se você não puder criar ou acessar um gráfico de conhecimento.

Remover uma máquina auxiliar

Você pode remover uma máquina auxiliar de um armazenamento de dados relacional utilizando o comando de REST do remove ArcGIS Server. Por exemplo, se você deseja usar um computador diferente para o modo auxiliar, você pode remover a máquina auxilixar antiga do armazenamento de dados, instale ArcGIS Data Store na nova máquina e configure-a como auxiliar.

Entre no ArcGIS Server Administrator Directory do servidor de hospedagem como o administrador de site do ArcGIS Server para utilizar o comando remover.

Gerenciar caches de resposta de consulta para camadas de feições hospedadas

Para camadas de feições hospedadas que são consultadas com frequência, o administrador do ArcGIS Server do servidor de hospedagem pode habilitar cache de resposta de consulta em camadas individuais para ajudar a melhorar o desempenho. Essas respostas de consulta são armazenadas em cache no armazenamento de objetos. Dependendo de quanto tempo os caches são armazenados (a política de expiração do cache) e quanto espaço em disco está disponível na máquina ou máquinas onde o armazenamento de objeto está sendo executado, o armazenamento de objeto pode ficar cheio e parar de funcionar.

Com o administrador do ArcGIS Data Store, você deve configurar o armazenamento de objeto em uma máquina ou máquinas separadas de outro software e garantir que haja amplo espaço em disco disponível para armazenar esses caches. Você também deve monitorar os logs do ArcGIS Data Store para detectar quando o armazenamento de objeto está se aproximando da capacidade. Você pode validar o armazenamento de objetos para determinar qual porcentagem de espaço em disco está em uso nas máquinas de armazenamento de objetos. Se necessário, trabalhe com o administrador do ArcGIS Server para alterar a política de expiração de cache ou para excluir caches de camadas grandes desabilitando o cache de resposta para essas camadas de feições.

Para informações sobre caches de resposta de consulta de feição e quando utilizá-los, consulte Para informações sobre caches de resposta de consulta de recursos e quando utilizá-los, consulte.

Para obter instruções sobre como habilitar o cache de resposta de consulta para camadas de feições hospedadas, consulte Camada de feição e Update Definition na ajuda do ArcGIS REST API.