SELECT - ABAP-Schlüsselwortdokumentation

ABAP - Schlüsselwortdokumentation → ABAP - Kurzreferenz → S

SELECT - Kurzreferenz

Syntax

SELECT [SINGLE [FOR UPDATE]]
       { [DISTINCT] { *
                    | { ..., data_source~*, ...,
                        col| agg_exp( [DISTINCT] col )| sql_exp} [AS alias], ... }
                    | (column_syntax)
         FROM { { {data_source [WITH PRIVILEGED ACCESS] [AS tabalias]}
                | { [(] {data_source [WITH PRIVILEGED ACCESS] [AS tabalias]}|join
                      {[INNER] JOIN}|{LEFT|RIGHT [OUTER [MANY TO ONE]] JOIN}|{CROSS JOIN}
                         {data_source [WITH PRIVILEGED ACCESS] [AS tabalias]}|join [ON join_cond] [)] }
                | (source_syntax) [WITH PRIVILEGED ACCESS] [AS tabalias] }
                [ {USING CLIENT clnt}
                | {CLIENT SPECIFIED [entity1~clnt] [, entity2~clnt] ...} ] } }
   | { FROM { { {data_source [WITH PRIVILEGED ACCESS] [AS tabalias]}
                | { [(] {data_source [WITH PRIVILEGED ACCESS] [AS tabalias]}|join
                      {[INNER] JOIN}|{LEFT|RIGHT [OUTER [MANY TO ONE]] JOIN}|{CROSS JOIN}
                         {data_source [WITH PRIVILEGED ACCESS] [AS tabalias]}|join [ON join_cond] [)] }
                | (source_syntax) [AS tabalias] }
                [ {USING CLIENT clnt}
                | {CLIENT SPECIFIED [entity1~clnt] [, entity2~clnt] ...} ] }
         FIELDS [DISTINCT]
                { *
                | { ..., data_source~*, ...,
                    col|agg_exp( [DISTINCT] col )| sql_exp} [AS alias], ... }
                | (column_syntax) }
       [[FOR ALL ENTRIES IN itab] WHERE sql_cond]
       [GROUP BY {col1| sql_exp1, col2| sql_exp2, ...}|(column_syntax)]
       [HAVING sql_cond]
       [UNION ALL|DISTINCT SELECT ...]
       [ORDER BY { {PRIMARY KEY}
                 |{{{col1|a1} [ASCENDING|DESCENDING],}
                   {{col2|a2} [ASCENDING|DESCENDING],}
                   ... }
                 | (column_syntax) }].
       { { INTO {[CORRESPONDING FIELDS OF] wa}|(dobj1, dobj2, ...) }
       | { INTO|APPENDING [CORRESPONDING FIELDS OF] TABLE itab
                          [PACKAGE SIZE n] }
       | { INTO @DATA(wa) }
       | { INTO TABLE @DATA(itab) [PACKAGE SIZE n] } }
       [ EXTENDED RESULT @oref ]
     [ CREATING {  READER|LOCATOR FOR { COLUMNS col1 col2 ... }
                                 | { ALL [OTHER] [BLOB|CLOB] COLUMNS }
                    [READER|LOCATOR FOR ...] }
                | {  (crea_syntax) } ]
       [UP TO n ROWS]
       [OFFSET o]
       [BYPASSING BUFFER]
       [CONNECTION con|(con_syntax)]
  ...
[ENDSELECT.]

Wirkung

Open-SQL-Anweisung. Liest Daten aus einer oder mehreren Datenbanktabellen in Datenobjekte. Wenn die Ergebnismenge nicht auf einmal zugewiesen wird, wird eine Schleife geöffnet, die mit ENDSELECT abgeschlossen werden muss und in der die Ergebnisse in den Zielfeldern zur Verfügung stehen.

Zusätze

Angabe der Zeilen:

SINGLE - Definiert eine einzeilige Ergebnismenge. Standardmäßig ist die Ergebnismenge mehrzeilig.
FOR UPDATE - Setzt eine Schreibsperre auf eine Einzelzeile auf der Datenbank.

Struktur der Ergebnismenge

FIELDS - Wird benötigt, wenn die FROM-Klausel vorher aufgeführt wird.
DISTINCT - Entfernt doppelt vorkommende Zeilen aus der Ergebnismenge.
* - Liest alle Spalten aller Datenquellen.
data_source~* - Liest alle Spalten der angegebenen Datenquelle.
col [AS alias] - Liest einzelne Spalten col und ordnet optional einen alternativen Spaltennamen alias zu.
agg_exp( [DISTINCT] col1 ) ... agg_exp( [DISTINCT] col2 ) ... - Wertet Aggregatfunktionen agg_exp für Spalten col1, col2, ... aus, wobei doppelt vorkommende Argumente ausgeschlossen werden können.
sql_exp - SQL-Ausdruck, der auf der Datenbank ausgewertet wird.
AS a1 ... AS a2 ... - Definiert alternative Spaltennamen a1, a2, ...
(column_syntax) - Gibt die Spalten als Inhalt von column_syntax an.

Angabe der Datenbanktabelle(n):

FROM data_source [AS tabalias]
Gibt eine Datenquelle data_source an. Möglich sind Datenbanktabellen, klassische Views und CDS-Entitäten des ABAP Dictionary, wobei an letztere auch Parameter übergeben werden können und Pfadangaben möglich sind. Zusätzlich kann auch eine interne Tabelle als Datenquelle angegeben werden.
FROM [(] {data_source [AS tabalias]}|join
{[INNER] JOIN}|{LEFT|RIGHT [OUTER [MANY TO ONE]] JOIN}|{CROSS JOIN}
{data_source [AS tabalias ]}|join [ON join_cond] [)]

Verknüpft mehrere Datenquellen in einem Join-Ausdruck. Es können innere und äußere Joins mit Join-Bedingungen join_cond sowie Cross Joins ohne Bedingungen gebildet werden.
WITH PRIVILEGED ACCESS
Schaltet die CDS-Zugriffskontrolle ab.
(source_syntax)
Gibt die Datenbanktabellen als Inhalt von source_syntax an.
AS tabalias
Definiert einen alternativen Tabellennamen tabalias.
USING CLIENT clnt
Stellt die automatische Mandantenbehandlung auf den in clnt angegebenen Mandanten um.
CLIENT SPECIFIED
Schaltet die automatische Mandantenbehandlung ab.

Angabe einer Bedingung:

FOR ALL ENTRIES IN itab
Ermöglicht hinter WHERE eine Bedingung auf alle Zeilen einer internen Tabelle itab.
WHERE sql_cond
Schränkt die Ergebnismenge durch eine Bedingung sql_cond ein. Die Bedingung kann aus verschiedenen relationalen Ausdrücken zusammengesetzt sein.

Angabe einer Gruppierung:

GROUP BY { {col1|sql_exp1, col2|sql_exp2, ...} | (column_syntax) }
Fasst Gruppen von Zeilen, die in den Spalten col1, col2, ... bzw. in SQL-Ausdrücken sql_exp1, sql_exp1, ... den gleichen Inhalt haben, zu einer Zeile der Ergebnismenge zusammen, wobei die Spalten dynamisch in column_syntax angegeben werden können.
HAVING sql_cond
Schränkt zu Gruppen zusammengefasste Zeilen in der Ergebnismenge durch eine Bedingung sql_cond ein.

Angabe einer Union:

UNION ALL|DISTINCT SELECT ...

Vereinigt die Zeilen der Ergebnismengen zweier SELECT-Anweisungen.

Angabe einer Sortierung:

ORDER BY
{PRIMARY KEY}|{{{col1|a1} [ASCENDING|DESCENDING],}
{{col2|a2} [ASCENDING|DESCENDING],} ...}|(column_syntax)

Sortiert die Ergebnismenge nach dem Primärschlüssel, statisch angegebenen Spalten col1, col2, ... bzw. a1, a2, ... oder dynamisch in column_syntax angegeben Spalten, wobei die Sortierrichtung für einzelne Spalten angegeben werden kann.

Angabe des Zielbereichs:

INTO wa|(dobj1, dobj2 ...)
Gibt einen Arbeitsbereich wa oder eine Liste von Datenobjekten dobj1, dobj2 ... als Zielfelder an.
INTO|APPENDING TABLE itab [PACKAGE SIZE n]
Gibt eine interne Tabelle itab als Zielbereich an. Die Ergebnismenge wird gesamt oder paketweise in die Tabelle geschrieben oder an diese angehängt.
CORRESPONDING FIELDS OF
Transportiert nur die Spalten, für die es gleichnamige Zielfelder gibt.
@DATA(wa), @DATA(itab)
Inline-Deklaration des Zielbereichs.
EXTENDED RESULT @oref
Stellt ein erweitertes Ergebnis in einem Ergebnisobjekt zur Verfügung.
CREATING READER|LOCATOR FOR ... COLUMNS ...
Gibt an, was für ein LOB-Handle erzeugt wird.

Angabe von Zusätzen:

UP TO n ROWS
Begrenzt die Anzahl der gelesenen Zeilen auf n.
OFFSET o
Liest die Zeilen ab dem Offset o.
BYPASSING BUFFER
Umgeht die Tabellenpufferung.
CONNECTION con|(con_syntax)
Führt die Anweisung auf einer Sekundärverbindung aus.