Met een SQL-bestand (ook wel "script" genoemd) kunnen specifieke mutaties in de database worden uitgevoerd. Het bestand wordt gemaakt door Syntess Software en bevat één of meer SQL-opdrachten.

 

Redenen om een SQL-bestand te maken zijn bijvoorbeeld:

- herstellen van een foutsituatie.

- doorvoeren van een wijziging die veel gegevens betreft.

- conversie van gegevens.

 

Sommige SQL-bestanden mogen worden uitgevoerd terwijl de database in gebruik is, bij andere SQL-bestanden is dat niet toegestaan. Dit is afhankelijk van de hoeveelheid en soort opdrachten in het SQL-bestand.

 

Database mag niet in gebruik zijn:

- Naam SQL-bestand is <mutatiebeschrijving>_AtriumMoetAfgesloten.sql.

- De Database Wizard moet buiten Syntess Atrium worden gestart (dit kan niet vanuit Extra, Beheer, Systeemgebruik).

 

Database mag wel in gebruik zijn:

- Naam SQL-bestand is <mutatiebeschrijving>_AtriumMagActief.sql.

- De Database Wizard kan worden gestart vanuit het scherm Extra, Beheer, Systeemgebruik, Overige functie "Uitvoeren SQL-bestand".

- De Database Wizard kan ook buiten Syntess Atrium worden gestart, de database mag dan in gebruik zijn.

 

hmtoggle_plus1Starten Uitvoeren SQL-bestand

 

De functie "Uitvoeren SQL-bestand" wordt uitgevoerd door de Syntess Atrium Database Wizard. De taak kan op verschillende wijzen worden gestart:

 

1. Handmatig vanuit het Windows-menu.

 

2. Via een commando in de Opdrachtprompt.

 

3. Automatisch via een taak in de Windows Taakplanner.

 

4. Via de overige functie "Uitvoeren SQL-bestand" in Syntess Atrium.

 

1. Handmatig vanuit het Windows-menu

Start de wizard en doorloop de eerste schermen zoals beschreven bij Starten van de Syntess Atrium Database Wizard.

 

Vervolgens zoals hieronder beschreven bij Schermverloop.

 

2. Via een commando in de Opdrachtprompt

"C:\Program Files (x86)\Syntess\Atrium\Bin\Atriumdb.exe" -d"<servernaam>:C:\ProgramData\Syntess\AtriumData\Atrium.fdb" -#9 -s -f"<pad en naam SQL bestand>"

 

Het commando moet worden aangepast op de servernaam en als atriumdb.exe of de database in een andere map staat.

 

Het pad van het SQL-bestand is een gewoon Windows-pad en moet bekend zijn op de computer waar het SQL-bestand wordt uitgevoerd. Het hoeft dus geen lokaal pad van de server te zijn zoals dat bij een databasepad het geval is.

 

Als er een afwijkend wachtwoord is voor SYSDBA moet dit als parameter worden meegegeven aan het commando, betreft:

-p"wachtwoord sysdba".

 

Na het uitvoeren van het commando in de opdrachtprompt worden geen invoerschermen getoond, maar wordt direct getoond wat er uitgevoerd gaat worden.

 

Dbw1060

Controleer of dit de juiste opdrachten zijn en kies [Uitvoeren].

 

Dbw1061

Na het tonen van de voortgang wordt de Database Wizard automatisch afgesloten.

 

3. Automatisch via een taak in de Windows Taakplanner

"C:\Program Files (x86)\Syntess\Atrium\Bin\Atriumdb.exe" -d"<servernaam>:C:\ProgramData\Syntess\AtriumData\Atrium.fdb" -#9 -q -f"<pad en naam SQL bestand>"

 

Het commando moet worden aangepast op de servernaam en als atriumdb.exe of de database in een andere map staat.

 

Automatisch uitvoeren zal in het algemeen niet nodig zijn omdat het uitvoeren van een SQL-bestand meestal eenmalig is. Het is echter wel mogelijk om het via een Windows-taak uit te voeren.

 

4. Via de overige functie 'Uitvoeren SQL-bestand'

In Syntess Atrium kan in de taak Extra, Beheer, Systeemgebruik met de overige functie "Uitvoeren SQL-bestand" een SQL-bestand worden gekozen om uit te voeren.

 

 

Dbw1031

 

Klik op Bijwerken en kies [Volgende].

 

Dbw1063

Selecteer "Uitvoeren SQL bestand".

 

Kies [Volgende].

 

Dbw1064

Kies via de knop [Bladeren…] het SQL bestand dat moet worden uitgevoerd of voer het pad handmatig in.

 

Dbw1065

Kies [Volgende].

 

De uit te voeren actie(s) worden getoond.

 

Dbw1060

Controleer of dit juist is en kies [Uitvoeren].

 

Als de database nog in gebruik is wordt dat hier gesignaleerd.

 

Dbw1061

De voortgang van het uitvoeren wordt getoond.

 

Als voor [Stoppen] wordt gekozen is er de melding:

 

Dbw1066

 

Na de keuze Ja worden alle acties terug gedraaid en de Database Wizard afgesloten.

 

Dbw1067

Het resultaat van de actie wordt getoond.

 

Kies [Sluiten]

 

 

Dit kan alleen met SQL-bestanden waar de naam eindigt op "_AtriumMagActief.sql".

 

Start Syntess Atrium en kies Extra, Beheer, Systeemgebruik, Overige functie "Uitvoeren SQL-bestand…".

 

Dbw1068

Selecteer het SQL-bestand.

 

Klik op [OK].

 

Let op: als de database niet in gebruik mag zijn tijdens het uitvoeren, volgt de melding:

Dit SQL-bestand kan alleen via de Syntess Atrium Database

Wizard worden gestart omdat Syntess Atrium niet in gebruik

mag zijn tijdens de uitvoering.

 

Dbw1060

 

Controleer of de juiste opdrachten worden getoond.

 

Kies [Uitvoeren].

 

Dbw1061

 

Na Uitvoeren wordt de Database Wizard automatisch afgesloten.

 

 

1 - Aanmaken van logbestand jjjjmmdd_atriumdb.log. Indien reeds aanwezig: toevoegen van tekst aan jjjjmmdd_atriumdb.log.

 

2 - Selecteren SQL-bestand en Uitvoeren kiezen.

 

3 - Database Offline zetten als SQL-bestand eindigt op "_AtriumMoetAfgesloten.sql".

Uitvoeren SQL-bestand

Database Online zetten als SQL-bestand eindigt op "_AtriumMoetAfgesloten.sql".

 

4 - Afsluiten van logbestand jjjjmmdd_atriumdb.log.

 

 

Indien goed verlopen:

Een database waarin de mutaties van het SQL-bestand juist zijn doorgevoerd.

 

Indien fout verlopen:

Tijdens het uitvoeren kan er een fout optreden. Hoe dat wordt afgehandeld, is afhankelijk van het type SQL-bestand.

 

- Naam SQL-bestand is <mutatiebeschrijving>_AtriumMoetAfgesloten.sql

Het uitvoeren van acties is afgebroken. Een deel van de acties is uitgevoerd. Het SQL-bestand moet worden aangepast om de fout op te lossen en de vervolgacties uit te voeren en/of voorgaande acties terug te draaien.

 

- Naam SQL-bestand is <mutatiebeschrijving>_AtriumMagActief.sql

Het uitvoeren van acties is afgebroken. Alle uitgevoerde acties worden teruggedraaid. De database kan gewoon worden gebruikt, maar de beoogde mutaties zijn niet doorgevoerd. Er moet een nieuw SQL-bestand worden aangeleverd dat geen problemen geeft bij uitvoering.