changedbproperties

Cet utilitaire ArcGIS Data Store est utilisé avec le relational data store, l’object store et le spatiotemporal Big Data store.

L’utilitaire changedbproperties vous permet de modifier diverses propriétés, selon le type de data store sur lequel vous l’exécutez.

Syntaxe

changedbproperties --store {relational | spatiotemporal | object} [configuration options]

Vous devez indiquer l’option --store et au moins une option de configuration. Vous trouverez ci-dessous les options de configuration prises en charge et leur description, ainsi que le type de data store avec lequel chaque option peut être utilisée :


Option de configuration	Description	Type de data store pris en charge
`--disk-threshold-readonly`	Cette option contrôle le moment où le relational data store est placé en mode de lecture seule pour éviter toute perte de données due à un espace disque insuffisant. Indiquez les tailles en Mo. L’espace disque par défaut est de 1 024 Mo.	Relational data store uniquement
`--max-connections`	Utilisez ce paramètre pour indiquer le nombre maximal de connexions autorisées à un relational data store. Par défaut, le relational data store accepte jusqu’à 150 connexions. Utilisez la propriété `--max-connections` pour modifier le nombre de connexions autorisées. Tenez compte du fait que les processus ArcGIS Data Store internes peuvent utiliser jusqu’à 5 connexions. Tenez également compte du nombre de connexions simultanées que la machine ArcGIS Data Store peut accepter sans compromis sur les performances. Si la machine exécutant ArcGIS Data Store ne dispose pas d’une mémoire importante, vous pouvez être amené à réduire le nombre de connexions autorisées. Le nombre spécifié ne peut pas être inférieur à 10. Lorsque vous changez le nombre maximum de connexions autorisées, ce nombre change à la fois sur la machine de stockage des données principale et sur celle de secours.	Relational data store uniquement
`--pitr`	Cette option indique si ArcGIS Data Store crée des sauvegardes incrémentielles du relational data store, ce qui permet de restaurer celui-ci dans l’état où il se trouvait à un moment donné dans le temps. Les arguments possibles pour cette option sont `enable` ou `disable`.	Relational data store uniquement Le paramètre par défaut est `--pitr disable`. Attention : La récupération ponctuelle dépend de la présence de sauvegardes automatiques complètes. Ne désactivez pas les sauvegardes automatiques si vous avez défini l’option `--pitr` sur `enable`. Vous devez définir l’option `--pitr` sur `enable` si vous souhaitez utiliser l’utilitaire webgisdr, installé avec Portal for ArcGIS, pour créer des sauvegardes incrémentielles du déploiement ArcGIS Enterprise.
`--enablessl`	Cette option contrôle l’utilisation du protocole TLS (Transport Layer Security) lors des communications entre le relational data store et le serveur d’hébergement. Les arguments pris en charge pour le paramètre `--enablessl` sont les suivants : `true` : il s’agit du paramètre par défaut. Le protocole TLS (Transport Layer Security) est utilisé lors des communications entre le relational data store et le serveur d’hébergement si vous spécifiez `--store relational`. `false` : spécifiez `false` et `--store relational` pour utiliser les communications HTTP entre le serveur d’hébergement et le relational data store.	Relational data store uniquement
`--heap-size`	Ce paramètre permet de modifier la quantité de mémoire du segment (en Mo) utilisée par un spatiotemporal big data store ou object store. Par défaut, au démarrage, un spatiotemporal big data store utilise la quantité de mémoire vive la plus faible entre 50 % de la mémoire vive totale et 70 % de la mémoire vive disponible. Vous pouvez redéfinir la taille de segment entre 512 et 32 000 Mo, mais assurez-vous que la taille spécifiée ne dépasse pas la quantité de RAM disponible sur la machine. Si le spatiotemporal Big Data store contient plusieurs machines, exécutez l’utilitaire changedbproperties sur chacune pour augmenter la taille de segment. La quantité de taille de segment utilisée par défaut par l’object store dépend de la quantité de mémoire vive disponible sur la machine. Dans la plupart des cas, l’object store utilise la quantité de mémoire vive la plus faible entre 50 % de la mémoire vive totale et 70 % de la mémoire vive disponible. Sur les machines dotées de plus de 20 Go de mémoire vive, l’object store utilise 40 % de la mémoire vive au démarrage, mais uniquement si la quantité de mémoire vive disponible est comprise entre 40 % et 70 % de la mémoire vive totale. Vous pouvez remplacer la taille de segment de l’object store par une valeur comprise entre 1024 Mo (minimum) et 124 000 Mo (maximum). Notez cependant les points suivants : Si la quantité de mémoire vive disponible sur la machine est comprise entre 16 Go et 32 Go, la taille de segment minimum viable pour l’object store est de 6 Go. Assurez-vous que la quantité que vous spécifiez pour la taille de segment ne dépasse pas la quantité de mémoire vive disponible sur la machine. Si l’object store contient plusieurs machines, toutes les machines du cluster sont mises à jour et l’object store redémarre sur toutes les machines du cluster.	Spatiotemporal big data store et object store uniquement
`--rebalance`	Par défaut, cette option est définie sur `true`, ce qui signifie que le spatiotemporal Big Data store distribue les données à d’autres machines, en cas d’indisponibilité d’une des machines. Si vous devez effectuer une opération de maintenance sur une machine de spatiotemporal Big Data store, pour la mettre à niveau par exemple, vous pouvez temporairement désactiver le rééquilibrage en spécifiant `--rebalance false`. L’option de rééquilibrage est interrompue pendant le nombre de minutes défini pour le paramètre `--max-rebalance-off`.	Spatiotemporal big data store uniquement
`--max-rebalance-off`	Combinée avec l’option `--rebalance`, cette option indique la durée de l’interruption du rééquilibrage. Par défaut, `--max-rebalance-off` est défini sur 60 minutes. Cela signifie que si vous désactivez temporairement le rééquilibrage, il redémarre au bout de 60 minutes. Si vous avez besoin de plus ou moins de temps que cela pour réaliser la tâche de maintenance pour laquelle vous avez interrompu le rééquilibrage, modifiez le paramètre `--max-rebalance-off`.	Spatiotemporal big data store uniquement
`--prompt`	vous exécutez cet utilitaire, vous êtes invité à confirmer l’action spécifiée. Si vous automatisez l’utilisation de cet utilitaire, spécifiez `--prompt no`. Sinon, le script ne continue que si vous répondez à l’invite.	Tous les data stores pris en charge par cet utilitaire

Exemples

Les sections suivantes comprennent des exemples d’utilisation des options disponibles avec l’utilitaire changedbproperties.

Changer le seuil de lecture seule pour le relational data store

Par défaut, le relational data store est placé en mode lecture seule lorsque l’espace disque libre passe en dessous de 1 024 Mo. Dans l’exemple suivant, puisque d’autres applications écrivent des données sur la machine, l’administrateur configure le relational data store de sorte qu’il soit placé plus tôt en mode lecture seule : lorsque l’espace disque libre sur la machine passe en dessous de 4 000 Mo.

./changedbproperties.sh --store relational --disk-threshold-readonly 4000

changedbproperties --store relational --disk-threshold-readonly 4000

You are changing the following database properties:
      ...disk space threshold to change relational store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Changer le nombre de connexions au relational data store autorisées

Dans cet exemple, le nombre maximal de connexions autorisées à un relational data store est défini sur 100 :

./changedbproperties.sh --store relational --max-connections 100

changedbproperties --store relational --max-connections 100

You are changing the following database properties:
      ...max number of connections to 100 (on all relational store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Activer la récupération ponctuelle pour le relational data store

Par défaut, la récupération ponctuelle est désactivée. Dans cet exemple, la récupération ponctuelle est activée pour le relational data store :

./changedbproperties.sh --store relational --pitr enable

changedbproperties --store relational --pitr enable

You are changing the following database properties:
      ...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Désactiver SSL

Par défaut, le relational data store communique avec le serveur d’hébergement via HTTPS. Dans cet exemple, le paramètre --enablessl est utilisé pour configurer le relational data store de sorte qu’il communique avec le serveur d’hébergement via HTTPS.

./changedbproperties.sh --store relational --enablessl false

changedbproperties --store relational --enablessl false

You are changing the following database properties:
      ...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Changer la taille de segment du spatiotemporal Big Data store ou de l’object store

Vous pouvez changer la quantité de mémoire vive utilisée au démarrage par le spatiotemporal big data store ou l’object store. Les valeurs de taille de segment sont exprimées en Mo.

Attention :

Diminuer la taille de segment pourrait empêcher le data store de démarrer. Si vous augmentez la taille de segment, ne spécifiez pas de chiffre dépassant la quantité de RAM disponible sur la machine.

Dans cet exemple, la taille de segment est définie sur 1 600 Mo sur une machine de spatiotemporal big data store.

./changedbproperties.sh --store spatiotemporal --heap-size 1600

changedbproperties --store spatiotemporal --heap-size 1600

You are changing the following database properties:
      ...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Dans cet exemple, la taille de segment est définie sur 2 400 Mo sur une machine d’object store.

./changedbproperties.sh --store object --heap-size 2400

changedbproperties --store object --heap-size 2400

You are changing the following database properties:
      ...heap size to 2400MB for the object store installed on this machine
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

Mettre en pause le rééquilibrage du spatiotemporal Big Data store

Dans cet exemple, l’administrateur doit effectuer une procédure de maintenance brève sur une machine du data store de Big Data spatio-temporel et ne souhaite pas que le data store soit rééquilibré. À cette fin, les options --rebalance et --max-rebalance-off sont utilisées pour suspendre le rééquilibrage pendant 30 minutes. Au bout de 30 minutes, le spatiotemporal Big Data store redéfinit automatiquement rebalance sur true.

Cette opération devant être effectuée régulièrement, l’administrateur conserve l’instruction suivante dans un script et définit l’option d’invite sur la valeur No (Non).

./changedbproperties.sh --store spatiotemporal --rebalance false --prompt no

./changedbproperties.sh --store spatiotemporal --max-rebalance-off 30 --prompt no

changedbproperties --store spatiotemporal --rebalance false --prompt no

changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no