Définition du modèle ThingWorx dans Composer > Stockage des données > Fournisseurs de persistance > Configuration de la base de données MSSQL pour ThingWorx : Windows
Configuration de la base de données MSSQL pour ThingWorx : Windows
Dans MSSQL Server, une connexion doit être créée avant la création d'un utilisateur. La connexion est créée en dehors de la base de données. Une base de données est ensuite créée. Dans la base de données, un utilisateur est créé et la connexion créée lui est affectée. Un schéma est ensuite créé dans la base de données. Enfin, le propriétaire du schéma sera l'utilisateur créé ci-dessus. En ce qui concerne ThingWorx, la connexion twadmin sera créée manuellement par SSMS. Les étapes restantes sont effectuées en exécutant des scripts bat.
* 
Si vous n'utilisez pas Windows, accédez à la rubrique Configuration de la base de données MSSQL pour ThingWorx : Linux.
Création de la connexion twadmin
* 
Avant d'exécuter les étapes suivantes, vérifiez que les étapes de la section Installation de SQL Server Management Studio (client d'administration de base de données) sur une machine Windows ont été effectuées.
Vous pouvez utiliser l'interface GUI ou la ligne de commande pour créer la connexion.
* 
Les étapes dans l'interface GUI sont présentées ci-dessous. Si vous utilisez l'éditeur de requête dans SSMS, entrez la commande Transact-SQL suivante : CREATE LOGIN twadmin WITH PASSWORD = '<mot_de_passe> ‘;
1. Dans SQL Server Management Studio (SSMS), ouvrez l'Explorateur d'objets et développez le dossier de l'instance de serveur dans laquelle créer la nouvelle connexion.
2. Cliquez avec le bouton droit sur le dossier de sécurité, faites-le pointer sur Nouveau, puis cliquez sur Connexion.
3. Dans la page Général, entrez le nom de la nouvelle connexion dans la zone Nom de connexion.
4. Sélectionnez Authentification SQL Server.
5. Entrez un mot de passe pour la connexion.
6. Cliquez sur OK.
Configuration et exécution du script de configuration de la base de données
1. Récupérez le script de configuration de la base de données (thingworxMssqlDBSetup.bat) dans le téléchargement de ThingWorx.
2. Ouvrez l'invite de commande et définissez le répertoire sur le dossier du script.
3. Entrez la commande ci-dessous :
thingworxMssqlDBSetup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -l <login-name> -d <thingworx-database-name> -u <thingworx-user-name> -s <schema-name>
4. Au moment de l'exécution, vous êtes invité à saisir le mot de passe associé au paramètre database-adminuser-name. Saisissez le mot de passe, puis validez.
Une fois le script exécuté, une base de données est créée et inclut un utilisateur avec une connexion associée. Le rôle db_owner est attribué à cet utilisateur sur la base de données créée. Un schéma est également créé s'il est fourni dans la ligne de commande. L'autorisation de ce schéma sera accordée à l'utilisateur créé.
Description des paramètres
Option
Paramètre
Par défaut
Description
Exemple
-h
server
localhost
Nom de domaine complet ou adresse IP du serveur de base de données
-h 10.0.0.221
-i
server-instance
<vierge>
Nom d'instance fourni lors de l'installation de la base de données
-i SQLEXPRESS
-p
port
1433
Port de SQL Server
-p 1433
-a
database-admin-user-name
sa
Nom d'utilisateur administrateur disposant des droits appropriés
-a sa
-l
login-name
twadmin
Nom de la connexion créée manuellement ci-dessus
-l twadmin
-d
thingworx-database-name
thingworx
Nom de la base de données
-d thingworx
-u
thingworx-user-name
<identique-au-nom-de-connexion>
Nom de l'utilisateur qui sera créé à l'intérieur de la base de données
-u twadmin
-s
schema-name
twschema
Nom du schéma créé dans la base de données thingworx
-s twschema
Configuration et exécution du script de schéma du fournisseur de données/modèles
1. A l'invite de commande, exécutez le fichier bat (thingworxMssqlSchemaSetup.bat) avec les paramètres appropriés (répertoriés dans la table ci-dessous) :
thingworxMssqlSchemaSetup.bat -h <server> -i <server-instance> -p <port> -l <login-name> -d <thingworx-database-name> -o <option (all,model,data,property,modelwithproperty)>
Lors de l'exécution du fichier bat, le système demande le mot de passe de la connexion (créée manuellement ci-dessus) pour chaque script. Entrez le mot de passe, puis validez à chaque fois.
A l'exécution de ces scripts, l'ensemble des tables, index et procédures requis pour la configuration de ThingWorx Platform est créé dans la base de données thingworx avec le schéma par défaut nommé twschema.
Description des paramètres
Option
Paramètre
Par défaut
Description
Exemple
-h
server
localhost
Nom de domaine complet ou adresse IP du serveur de base de données
-h 10.0.0.221
-i
server-instance
<vierge>
Nom d'instance fourni lors de l'installation de la base de données
-i SQLEXPRESS
-p
port
1433
Port de SQL Server
-p 1433
-l
login-name
twadmin
Nom de la connexion créée manuellement ci-dessus
-l twadmin
-d
thingworx-database-name
thingworx
Nom de la base de données
-d thingworx
-o
option
all
Pour exécuter tous les scripts. Le modèle, les données, la propriété et le modèle avec propriétés seront exécutés.
-o all
Configuration et exécution du script de nettoyage de la base de données
Le script bat de nettoyage de la base de données (thingworxMssqlDBCleanup.bat) est fourni à des fins de commodité et de développement/test. Cette opération n'est requise que si les données et l'objet de base de données doivent être effacés pour reprendre à zéro.
1. A l'invite de commande, exécutez le fichier bat avec les paramètres appropriés (répertoriés dans la table ci-dessous) :
thingworxMssqlDBCleanup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -d <thingworx-database-name>

Description des paramètres
Option
Paramètre
Par défaut
Description
Exemple
-h
server
localhost
Nom de domaine complet ou adresse IP du serveur de base de données
-h 10.0.0.221
-i
server-instance
<vierge>
Nom d'instance fourni lors de l'installation de la base de données
-i SQLEXPRESS
-p
port
1433
Port de SQL Server
-p 1433
-a
database-admin-user-name
sa
Nom d'utilisateur administrateur disposant des droits appropriés
-a sa
-d
thingworx-database-name
thingworx
Nom de la base de données
-d thingworx