Comandos de REST do ArcGIS Data Store

Quando você configura o ArcGIS Data Store, você associa ele com o site do GIS ServerGIS Server que servirá como seu servidor de hospedagem do portal. 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 ou armazenamento de dados de cache de mosaico em execução no modo de espera principal e remover a máquina em espera do site do GIS Server no ArcGIS Server Administrator Directory. 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 do cache de mosaico—Clique em dados > itens > nosqlDatabases > AGSDataStore_nosql_<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. Também é possível promover um armazenamento de dados relacional auxiliar, um armazenamento de dados de cache de mosaico ou uma máquina de armazenamento gráfico como 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 auxiliar para primária utilizando 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:

• parar
• iniciar
• makePrimary (máquinas auxiliares em um armazenamento de dados relacional, armazenamento de gráfico ou armazenamento de dados de cache de mosaico somente no modo primário-auxiliar)

Validar o armazenamento de dados

Você pode verificar o status das máquinas em um armazenamento de dados usando o comando REST validar 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. Esse valor é retornado para armazenamentos de gráficos e armazenamentos de dados relacionais quando a máquina primária está íntegra, mas a máquina auxiliar não está disponível. O armazenamento gráfico ou armazenamento de dados relacionais não está altamente disponível neste momento. Para armazenamentos de objetos que contenham mais de uma máquina, o armazenamento de dados pode não estar altamente disponível dependendo de quantas máquinas estiverem no agrupamento.
  • 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 de cache de mosaico ou relacional, 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—Isso se aplica a máquinas em um armazenamento de dados relacional, armazenamento de gráfico ou armazenamento de dados de cache de mosaico auxiliar principal apenas e indica se a máquina é primária ou auxiliar. Para um armazenamento de objetos, o papel será primário para uma única instância e cluster_member para um armazenamento de objetos implantado no modo de agrupamento.
• mensagens—Você verá o aviso e mensagens de erros relacionados ao status do armazenamento de dados aqui. Por exemplo, se você validar um armazenamento de dados do cache de mosaico de máquina múltipla, você receberá uma mensagem se os dados de cache da cena não estiverem altamente disponível atualmente (em outras palavras, há somente uma cópia de um ou mais dos caches de cena).

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.
• Identifique se o armazenamento de dados do cache de mosaico está em um estado altamente disponível.
• 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, se você não puder criar ou acessar um gráfico de conhecimento ou não puder executar o GeoAnalytics Tools.

Remover uma máquina auxiliar

Você pode remover uma máquina auxiliar de um armazenamento de dados relacional ou armazenamento de dados de cache de mosaico auxilixar principal usando o comando REST remover 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. Uma vez ativado, cada vez que o serviço de feição recebe uma consulta exclusiva, as feições e a extensão 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 objeto para ver qual porcentagem de espaço em disco está em uso nas máquinas de armazenamento de objeto e executar um utilitário para determinar quais caches da camada são maiores. Se necessário, trabalhe com o administrador do ArcGIS Server para alterar a política de expiração do cache ou para excluir caches de camadas grandes.

Ativar cache de resposta de consulta para camadas de feição

Para habilitar o cache em uma camada ou camadas em uma camada de feição hospedada (serviço de feição), o administrador do ArcGIS Server do site de servidor de hospedagem deve registrar no Administrator Directory do ArcGIS Server do servidor de hospedagem e enviar a seguinte solicitação com a operação REST Atualizar Definição:

{
    "layerCache": {
        "enabled": true
    }
}

Se os dados são atualizados com frequência, não habilite o cache; sempre que a camada é atualizada, o cache precisa ser reconstruído, para que você não veja nenhum ganho de desempenho ao usar consultas em cache em camadas de feições editadas com frequência.

Definir ou alterar a política de expiração do cache

Os caches são construídos por consulta única. Se você tiver espaço em disco suficiente na máquina de armazenamento de objeto e a camada for acessada por muitos clientes, defina o cache para não expirar. A solicitação de exemplo mostrada na seção anterior permite o armazenamento em cache sem expiração.

Para camadas que não são acessadas continuamente, ou se o espaço em disco for uma preocupação, defina por quanto tempo (em dias) o cache de resposta de consulta de uma camada é retido.

{
    "layerCache": {
        "enabled": true, 
        "expiration": <duration_in_days>
    }
}

Esteja ciente de que os caches expiram à meia-noite no horário UTC. Se você definir a política de expiração como 1, o cache pode persistir por até quase dois dias, dependendo de quando o cache é criado.

Por exemplo, se um cliente acessa uma camada de feição às 4:00 UTC, seu cache persistirá até as 24:00 UTC do dia seguinte.

Excluir um cache de uma camada

Se o armazenamento de objeto estiver ficando sem espaço em disco, você verá um aviso nos logs do ArcGIS Data Store e o comando REST validar mostrará quanto espaço em disco é usado. Você não pode adicionar espaço em disco ou máquinas a um armazenamento de objeto existente, portanto, pode ser necessário limpar os caches para liberar espaço em disco. Para fazer isto, o administrador do ArcGIS Server do servidor de hospedagem deve desativar o cache desta camada.

{
    "layerCache": {
        "enabled": false
    }
}