Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Gespeicherte Prozeduren für Tablespaces von RDS für Db2
Mit den in diesem Thema beschrieben integrierten gespeicherten Prozeduren werden Tablespaces für Datenbanken von Amazon RDS für Db2 verwaltet. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung mit der Datenbank `rdsadmin` herstellen.
Diese gespeicherten Prozeduren werden für eine Vielzahl von Aufgaben verwendet. Diese Liste ist nicht umfassend.
+ [Häufige Aufgaben in Bezug auf Tablespaces](db2-managing-tablespaces.md)
+ [Generieren von Leistungsberichten](db2-managing-databases.md#db2-generating-performance-reports)
+ [Kopieren von Datenbank-Metadaten mit db2look](db2-native-db2-tools-db2look.md)
+ [Erstellen einer Repository-Datenbank für IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.create\$1tablespace](#db2-sp-create-tablespace)
+ [rdsadmin.alter\$1tablespace](#db2-sp-alter-tablespace)
+ [rdsadmin.rename\$1tablespace](#db2-sp-rename-tablespace)
+ [rdsadmin.drop\$1tablespace](#db2-sp-drop-tablespace)
## rdsadmin.create\$1tablespace
Erstellt ein Tablespace.
### Syntax
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_page_size,
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type',
'tablespace_prefetch_size')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, in der die Partition erstellt wird. Der Datentyp ist `varchar`.
*tablespace\$1name*
Der Name des zu erstellenden Tablespace. Der Datentyp ist `varchar`.
Der Name des Tablespace weist die folgenden Einschränkungen auf:
+ Er darf nicht mit dem Namen eines vorhandenen Tablespace in dieser Datenbank identisch sein.
+ Er kann nur die Zeichen `_$#@a-zA-Z0-9` enthalten.
+ Er darf nicht mit `_` oder `$` beginnen.
+ Er darf nicht mit `SYS` beginnen.
Die folgenden Parameter sind optional:
*buffer\$1pool\$1name*
Der Name des Pufferpools, dem das Tablespace zugewiesen werden soll. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge.
Sie müssen bereits über einen Pufferpool mit derselben Seitengröße verfügen, um ihn mit dem Tablespace verknüpfen zu können.
*tablespace\$1page\$1size*
Die Seitengröße des Tablespace in Bytes. Der Datentyp ist `integer`. Zulässige Werte: `4096`, `8192`, `16384`, `32768`. Die Standardeinstellung ist die Seitengröße, die Sie beim Erstellen der Datenbank durch Aufrufen von [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) verwendet haben.
Amazon RDS unterstützt Write-Atomizität für Seiten mit 4 KiB, 8 KiB und 16 KiB. Im Gegensatz dazu besteht bei Seiten mit 32 KiB die Gefahr, dass Schreibvorgänge fehlerhaft sind oder dass partielle Daten auf den Desk geschrieben werden. Wenn Sie Seiten mit 32 KiB verwenden, empfehlen wir Ihnen, die point-in-time Wiederherstellung und automatische Backups zu aktivieren. Andernfalls ist nach fehlerhaften Schreibvorgängen keine Wiederherstellung möglich. Weitere Informationen erhalten Sie unter [Einführung in Backups](USER_WorkingWithAutomatedBackups.md) und [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
*tablespace\$1initial\$1size*
Die Anfangsgröße des Tablespace in Kilobyte (KB). Der Datentyp ist `integer`. Gültige Werte: `48` oder höher. Der Standardwert ist „null“.
Wenn Sie keinen Wert festlegen, legt Db2 einen geeigneten Wert für Sie fest.
Dieser Parameter gilt nicht für temporäre Tablespaces, da diese vom System verwaltet werden.
*tablespace\$1increase\$1size*
Der Prozentsatz, um den das Tablespace vergrößert werden soll, wenn es voll ist. Der Datentyp ist `integer`. Gültige Werte: `1`–`100`. Der Standardwert ist „null“.
Wenn Sie keinen Wert festlegen, legt Db2 einen geeigneten Wert für Sie fest.
Dieser Parameter gilt nicht für temporäre Tablespaces, da diese vom System verwaltet werden.
*tablespace\$1type*
Der Typ des Tablespace. Der Datentyp ist `char`. Gültige Werte: `U` (für Benutzerdaten), `T` (für temporäre Benutzerdaten) oder `S` (für temporäre Systemdaten). Der Standardwert ist `U`.
*tablespace\$1prefetch\$1size*
Die Speichervorgriff-Seitengröße des Tablespace. Der Datentyp ist `char`. Gültige Werte: `AUTOMATIC` (Groß- und Kleinschreibung wird nicht berücksichtigt) oder positive Ganzzahlen ungleich Null, die kleiner als oder gleich 32767 sind.
### Nutzungshinweise
RDS für Db2 erstellt immer eine große Datenbank für Daten.
Informationen zum Überprüfen des Status beim Erstellen eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Erstellen eines Tablespace und Zuweisen eines Pufferpools**
Im folgenden Beispiel wird das Tablespace `SP8` erstellt und der Pufferpool `BP8` für die Datenbank `TESTDB` zugewiesen. Das Tablespace hat eine ursprüngliche Tablespace-Seitengröße von 4096 Byte, ein ursprüngliches Tablespace von 1000 KB und die Erweiterung der Tabellengröße ist auf 50 % festgelegt.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
4096,
1000,
50)"
```
**Beispiel 2: Erstellen eines temporären Tablespace und Zuweisen eines Pufferpools**
Im folgenden Beispiel wird das temporäre Tablespace `SP8` erstellt. Es weist den Pufferpool `BP8` mit einer Größe von 8 KiB für die Datenbank `TESTDB` zu.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
8192,
NULL,
NULL,
'T')"
```
**Beispiel 3: Erstellen eines Tablespace und Zuweisen einer Speichervorgriff-Seitengröße**
Im folgenden Beispiel wird das Tablespace `SP8` für die Datenbank `TESTDB` zugewiesen. Das Tablespace hat eine ursprüngliche Tablespace-Erweiterungsgröße von `50` und eine Speichervorgriff-Seitengröße von `800`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
NULL,
NULL,
NULL,
50,
NULL,
'800')"
```
## rdsadmin.alter\$1tablespace
Ändert ein Tablespace.
### Syntax
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_increase_size,
'max_size',
'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online',
'tablespace_prefetch_size')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, die das Tablespace verwendet. Der Datentyp ist `varchar`.
*tablespace\$1name*
Der Name des zu ändernden Tablespace. Der Datentyp ist `varchar`.
Die folgenden Parameter sind optional:
*buffer\$1pool\$1name*
Der Name des Pufferpools, dem das Tablespace zugewiesen werden soll. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge.
Sie müssen bereits über einen Pufferpool mit derselben Seitengröße verfügen, um ihn mit dem Tablespace verknüpfen zu können.
*tablespace\$1increase\$1size*
Der Prozentsatz, um den das Tablespace vergrößert werden soll, wenn es voll ist. Der Datentyp ist `integer`. Gültige Werte: `1`–`100`. Der Standardwert ist `0`.
*max\$1size*
Die maximale Größe für das Tablespace. Der Datentyp ist `varchar`. Gültige Werte: *integer* `K` \$1 `M` \$1`G`, oder`NONE`. Der Standardwert ist `NONE`.
*reduce\$1max*
Gibt an, ob der Wert für „High Water Mark“ auf den maximalen Grenzwert reduziert werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*reduce\$1stop*
Gibt an, ob der vorhergehende Befehl `reduce_max` oder der Befehl `reduce_value` unterbrochen werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*reduce\$1value*
Der Wert oder der Prozentsatz, um den der Wert für „High Water Mark“ im Tablespace reduziert werden soll. Der Datentyp ist `varchar`. Gültige Werte: *integer* `K` `M` \$1 \$1 `G` oder `1` —`100`. Der Standardwert ist `N`.
*lower\$1high\$1water*
Gibt an, ob der Befehl `ALTER TABLESPACE LOWER HIGH WATER MARK` ausgeführt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*lower\$1high\$1water\$1stop*
Gibt an, ob der Befehl `ALTER TABLESPACE LOWER HIGH WATER MARK STOP` ausgeführt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*switch\$1online*
Gibt an, ob der Befehl `ALTER TABLESPACE SWITCH ONLINE` ausgeführt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*tablespace\$1prefetch\$1size*
Die Speichervorgriff-Seitengröße des Tablespace. Der Datentyp ist `char`. Gültige Werte: `AUTOMATIC` (Groß- und Kleinschreibung wird nicht berücksichtigt) oder positive Ganzzahlen ungleich Null, die kleiner als oder gleich 32767 sind.
Dieser Parameter funktioniert nur mit `buffer_pool_name`, `table_increase_size`, `max_size` und `switch_online`. Er funktioniert nicht mit `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water` und `lower_high_water_stop`.
### Nutzungshinweise
Bevor Sie die gespeicherte Prozedur aufrufen, lesen Sie die folgenden Hinweise:
+ Die gespeicherte Prozedur `rdsadmin.alter_tablespace` funktioniert nicht in einem Tablespace, in dem `tablespace_type` für temporäre Benutzerdaten auf `T` festgelegt ist.
+ Die Parameter `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` und `switch_online` schließen sich gegenseitig aus. Sie können nicht mit anderen optionalen Parametern wie `buffer_pool_name` im Befehl `rdsadmin.alter_tablespace` kombiniert werden. Weitere Informationen finden Sie unter [Statement not valid](db2-troubleshooting.md#alter-tablespace-sp-statement-not-valid).
Informationen zum Überprüfen des Status beim Ändern eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von gespeicherten Prozeduren zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
**Beispiel 1: Senken des Werts für „High Water Mark“**
Im folgenden Beispiel wird das Tablespace `SP8` geändert und der Pufferpool `BP8` für die Datenbank `TESTDB` zugewiesen, um den Wert für „High Water Mark“ zu senken.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'SP8',
'BP8',
NULL,
NULL,
'Y')"
```
**Beispiel 2: Reduzieren des Werts für „High Water Mark“**
Im folgenden Beispiel wird der Befehl `REDUCE MAX` im Tablespace `TBSP_TEST` in der Datenbank `TESTDB` ausgeführt.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
'Y')"
```
**Beispiel 3: Unterbrechen von Befehlen, um den Wert für „High Water Mark“ zu reduzieren**
Im folgenden Beispiel wird der Befehl `REDUCE STOP` im Tablespace `TBSP_TEST` in der Datenbank `TESTDB` ausgeführt.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
'Y')"
```
**Beispiel 4: Ändern der vorhandenen Speichervorgriff-Seitengröße**
Im folgenden Beispiel wird der Befehl `ALTER TABLESPACE SWITCH ONLINE` für das Tablespace `TSBP_TEST` ausgeführt und die vorhandene Speichervorgriff-Seitengröße auf `64` geändert.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
‘Y’,
‘64’)"
```
## rdsadmin.rename\$1tablespace
Benennt ein Tablespace um.
### Syntax
```
db2 "call rdsadmin.rename_tablespace(
?,
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur „?“.
*database\$1name*
Der Name der Datenbank, zu der das Tablespace gehört. Der Datentyp ist `varchar`.
*source\$1tablespace\$1name*
Der Name des Tablespace, das umbenannt werden soll. Der Datentyp ist `varchar`.
*target\$1tablespace\$1name*
Der neue Name des Tablespace. Der Datentyp ist `varchar`.
Der neue Name weist die folgenden Einschränkungen auf:
+ Er darf nicht mit dem Namen eines vorhandenen Tablespace identisch sein.
+ Er kann nur die Zeichen `_$#@a-zA-Z0-9` enthalten.
+ Er darf nicht mit `_` oder `$` beginnen.
+ Er darf nicht mit `SYS` beginnen.
### Nutzungshinweise
Informationen zum Überprüfen des Status beim Umbenennen eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Sie können Tablespaces, die zur Datenbank `rdsadmin` gehören, nicht umbenennen.
### Beispiele
Im folgenden Beispiel wird das Tablespace `SP8` in der Datenbank `TESTDB` in `SP9` umbenannt.
```
db2 "call rdsadmin.rename_tablespace(
?,
'TESTDB',
'SP8',
'SP9')"
```
## rdsadmin.drop\$1tablespace
Verwirft ein Tablespace.
### Syntax
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, zu der das Tablespace gehört. Der Datentyp ist `varchar`.
*tablespace\$1name*
Der Name des Tablespace, das verworfen werden soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Informationen zum Überprüfen des Status beim Verwerfen eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird das Tablespace `SP8` aus der Datenbank `TESTDB` verworfen.
```
db2 "call rdsadmin.drop_tablespace(
'TESTDB',
'SP8')"
```