Yaslaw.Info

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== [VBA][Access] Klasse SQLScript - SQL Befehle ======
Diese Beispiele basieren alle auf der Klasse [[vba:access:classes:sqlscript]].
Es werden hier nur die SQL-Statements gezeigt und den Rückgabewert.

===== Anmerkungen =====
==== Befehlsabschluss ; ====
Bei Einzelscripte ist kein ; am Ende des Befehls notwendig. Das Semicolon schadet aber auch nicht. Bei Scripten mit mehreren Befehlen ist das ; am Ende Notwendig. Nach dem ; darf auf der zeile bis auf Leerzeichen nichts mehr folgen
<code sql>SELECT * FROM my_table;
SELECT *
FROM my_table
;</code>
=== Spezialfälle ===
Das ; am Ende einer Zeile wird nicht als Befehlsende intepretiert, wenn die Zeile eine Kommentarzeile ist. Also mit -- beginnt. Oder wenn die Zeile mit PARAMETERS beginnt. Dann ist es eine Paramterzeile eines SQLs
<code sql>-- Dies ist ein Tast;

CREATE OR REPLACE VIEW vw_test AS 
-- Das ; in der folgenden Zeile wird nicht als Befehlsende intepretiert
PARAMETERS [P_ID] Long;
SELECT t.*
FROM tbl_test AS t
WHERE t.id = [P_ID];
-- hingegen endet der SQL-Befehm nach dem ; auf der vorhergehenden Zeile</code>


==== Komentarzeilen -- ====
SQLScript erlaubt Komentarzeilen in Code. Jede Zeile, die mit einem -- beginnt (es darf Leerzeichen (Space, Tab) davor haben) wird als Komentarzeile angesehen und vor dem Ausführen entfernt. Kommentare hinter dem Code wird nicht als solcher erkannt. Jeder Kommentar muss also auf eine eigene Zeile

<code sql>-- Hallo Welt
SELECT
    -- Als erstes geben wir die ID aus
    id,
    ...</code>

===== PROMPT =====
<code> PROMPT text</code>
Im Gegensatz zum Komentar mittels %%--%% ist PROMPT durchaus ein Befehl. Der Text nach PROMPT wird beim Ausführen eines Scriptes zurückgegeben. Der Befehl macht vor allem in grösseren Scripten Sinn, um in der Ausgabe Notizen zu hinterlassen bei welchem Schritt man gerade ist.
>Da PROMPT ein Befehlist, muss die Zeile in einem Script mit mehreren Befehlen mit ; abgeschlossenwerden

===== Einfache Access-SQL =====
Auf einfache SELECT etc. gehe ich hier nicht weiter ein. Die Doku dazu findest du unter den folgenden Links
== DDL ==
Data Definition Language (DDL, deutsch „Datenbeschreibungssprache“)
  * [[https://msdn.microsoft.com/en-us/library/office/ff196148.aspx|ALTER TABLE Statement (Microsoft Access SQL)]]
  * [[https://msdn.microsoft.com/en-us/library/office/ff823109.aspx|CREATE INDEX Statement (Microsoft Access SQL)]]
  * [[https://msdn.microsoft.com/en-us/library/office/ff837200.aspx|CREATE TABLE Statement (Microsoft Access SQL)]]
  * [[https://msdn.microsoft.com/en-us/library/office/ff836312.aspx|CREATE VIEW Statement (Microsoft Access SQL)]]
  * [[https://msdn.microsoft.com/en-us/library/office/ff821409.aspx|DROP Statement (Microsoft Access SQL)]]

== DML ==
Data Manipulation Language (DML, deutsch „Datenverarbeitungssprache“)
  * [[https://msdn.microsoft.com/en-us/library/office/ff195097.aspx|DELETE Statement (Microsoft Access SQL)]]
  * [[https://msdn.microsoft.com/en-us/library/office/ff834799.aspx|INSERT INTO Statement (Microsoft Access SQL)]]
  * [[https://msdn.microsoft.com/en-us/library/office/ff845036.aspx|UPDATE Statement (Microsoft Access SQL)]]

== DCL ==
Data Control Language (DCL, deutsch „Datenaufsichtssprache“)
  * [[https://msdn.microsoft.com/en-us/library/office/ff821148.aspx|SELECT Statement (Microsoft Access SQL)]]

===== SET =====
<code>SET param = value</code>
Ms Access SQL kennt bei den Abfragen Variablen/Parameters. SQLScript kann damit arbeiten. Wenn man einem Parameter einen Wert zuteilt, bleibt der erhalten bis der Cache des Containers gelehrt wird.
\\ Siehe auch [[#SELECT mit Parametern/Variabeln]]

Setzen eines Wertes geht über die Funktion SET
<code sql>SET act_id = 13</code>
<code sql>SET search_date = #01-01-2015#</code>
Somit haben wir jetzt eine Variabel act_id mit dem Wert 13 und search_date mit dem ersten Tag im 2015.
Diese Variablen kann an wie gewohnt im Access mittels SELECT abfragen. Oder man kann sie in einem Filter brauchen. Genauso wie die benannten Parameter einer Abfrage.

Hier mein Testscript, dass ich über die Konole aufrufe
<code sql>SET act_id = 13;
PROMPT IN der Tabelle die ID [act_id] herausfiltern;
SELECT * FROM tbl_t1 WHERE id = act_id;</code>
<code>Set Paramter [ACT_ID] to 13

> IN der Tabelle die ID [act_id] herausfiltern

| id | val |
|----|-----|
| 13 | ABC |</code>

===== SELECT mit Parametern/Variabeln =====
Wie in [[#SET]] bereits erwähnt, kennt MS Access SQL Paramter.
Entweder sind sie vordefiniert oder aber es sind Feldnamen die in der Quelle nicht vorhanden sind. Wir kennen dass, wenn man eine Abfrage öffnet und Access fragt nach einem Wert für ein Feld.

Ind em folgenden SQL ist [act_id] ein undefinierter Paramter. 
<code sql>SELECT t.*
FROM tbl_t1 AS t
WHERE t.id = [act_id];</code>
Beim ausführen erscheint eine Inputbox, die nach dem Wert für act_id fragt. Dieser Wert wird anschliessend in den Cache des Containers gespeichert. Analog zum Scriptseiten [[#SET]].
>Hier ein %%PrintScreen%% aus der [[vba:access:sqlscript:sqlconsole]]: {{:vba:access:sqlscript:sql_console_3.jpg?linkonly|Arbeiten mit Variablen ohne SET}}

Die aktiven Werte für gecachte Variabeln kann man mittels [[#SHOW Variables/Paramters]] überprüfen.

===== CLEAR CHACHE =====
<code>CLEAR CACHE
CLEAR CACHE var_name</code>
Um gerade noch bei den Variablen zu bleiben. Mittels CLEAR CACHE können die Variablen gelöscht werden.
Wenn kein Variablenname angegeben wird, wird der ganez Cache gelöscht. Ansonsten nur die eine Variable.

Hier mal ein Beispiel aus der Konsole
<code sql>SET a = 1;
SET b = 2;
SET c = 3;
SHOW VARIABLES;
-- Nur Variable B löschen
CLEAR CACHE b;
SHOW VARIABLES;
-- Alle Variablen löschen
CLEAR CACHE;
SHOW VARIABLES;</code>
<code>Set Paramter [A] to 1

Set Paramter [B] to 2

Set Paramter [C] to 3

| variable_name | type | value |
|---------------|------|-------|
| A             | BYTE | 1     |
| B             | BYTE | 2     |
| C             | BYTE | 3     |

Clear Cache for Variable [B]

| variable_name | type | value |
|---------------|------|-------|
| A             | BYTE | 1     |
| C             | BYTE | 3     |

Clear Cache

| variable_name | type | value |
|---------------|------|-------|
</code>

===== SHOW =====
''SHOW'' ist ein Befehl, den man aus anderen DBMS kennt um Objekte in der Datenbank anzuzeigen. Tabellen, Spalten etc.

SQLScript kennt mehrere verschiedene Objekte die analysiert werden können

==== SHOW VIEWS/TABLES ====
<code>SHOW TABLES [WHERE conditions]
SHOW VIEWS [WHERE conditions]</code>

=== Alle Tabellen ausgeben ===
<code sql>SHOW TABLES</code>
<code>| table_name                  | row_count | last_update         | indexes                                    |
|-----------------------------|-----------|---------------------|--------------------------------------------|
| ADDON_SQL_CONSOLE_SESSION   | 19        | 13.04.2015 12:57:28 | ID, PrimaryKey (PK)                        |
| t_sql_test                  | 1         | 17.04.2015 10:08:24 | idx_sql_val, Index_F44530CA_8088_4FED (PK) |
| tbl_t1                      | 2         | 13.04.2015 12:09:01 | idx_val, Index_B4C4285A_B98F_4415 (PK)     |
| TODO: ADDON_SQL_CONSOLE_LOG | 0         | 13.04.2015 12:26:40 | PrimaryKey (PK), SESSION_ID, STEP_ID       |</code>

=== Liste filtern ===
<code sql>SHOW TABLES WHERE table_name LIKE '*_t*';</code>
<code>| table_name | row_count | last_update         | indexes                                    |
|------------|-----------|---------------------|--------------------------------------------|
| t_sql_test | 1         | 17.04.2015 10:08:24 | idx_sql_val, Index_F44530CA_8088_4FED (PK) |
| tbl_t1     | 2         | 13.04.2015 12:09:01 | idx_val, Index_B4C4285A_B98F_4415 (PK)     |</code>

==== SHOW COLUMNS ====
<code>SHOW COLUMNS FROM table
SHOW COLUMNS FROM view</code>
Zeigt die Spalten einer Tabelle oder einer View mit ihren Eigenschafte an

=== Table ===
<code sql>SHOW COLUMNS FROM tbl_t1;</code>
<code>| nr | field_name | field_type | allow_zero_length | required | source_table | source_field | autoincrement | default_value |
|----|------------|------------|-------------------|----------|--------------|--------------|---------------|---------------|
| 1  | id         | LONG       | False             | False    | tbl_t1       | id           | False         |               |
| 2  | val        | TEXT(25)   | False             | False    | tbl_t1       | val          | False         |               |
</code>

=== View ===
<code sql>SHOW COLUMNS FROM vw_t1;</code>
<code>| nr | field_name | field_type | allow_zero_length | required | source_table | source_field | autoincrement | default_value |
|----|------------|------------|-------------------|----------|--------------|--------------|---------------|---------------|
| 1  | id         | LONG       | False             | False    | tbl_t1       | id           | False         |               |
| 2  | val        | TEXT(25)   | False             | False    | tbl_t1       | val          | False         |               |
| 3  | jetzt      | DATE       | False             | False    |              |              | False         |               |
</code>

==== SHOW INDEXES ====
<code>SHOW INDEXES FROM table</code>
<code sql>SHOW INDEXES FROM tbl_t1;</code>
<code>| index_name               | primary_key | unique |
|--------------------------|-------------|--------|
| idx_val                  | False       | False  |
| Index_B4C4285A_B98F_4415 | True        | True   |</code>

==== SHOW Variables/Paramters ====
<code>SHOW VARIABLES</code>
Zeigt alle Variablen an. Zum Thema Variabeln siehe auch [[#SET]], [[#SELECT mit Parametern/Variabeln]].
\\ Ein Beispiel für SHOW VARIABLES; siehst du bei [[#CLEAR CHACHE]]

<code vb>SET a = 3;
SET b = 'abc';
-- Eine Variable als undefinierte Variable mittels eines SELECT erzwingen (siehe auch SELECT mit Parametern/Variabeln)
SELECT c; 
SET d = NOW();
-- Alle Variabeln anzeigen
SHOW VARIABLES;</code>
<code>Set Paramter [A] to 3

Set Paramter [B] to abc

| c    |
|------|
| 1234 |

Set Paramter [D] to 20.04.2015 08:48:05

| variable_name | type     | value                 |
|---------------|----------|-----------------------|
| D             | DATE     | #04-20-2015 08:48:05# |
| A             | BYTE     | 3                     |
| B             | TEXT(50) | 'abc'                 |
| C             | INTEGER  | 1234                  |</code>
Yaslaw.Info

User Tools

Site Tools

Page Tools
