Gespeicherte Prozeduren für Tablespaces für Db2 RDS - Amazon Relational Database Service
rdsadmin.create_tablespacerdsadmin.alter_tablespacerdsadmin.rename_tablespacerdsadmin.drop_tablespace

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 für Db2 RDS

Die folgenden gespeicherten Prozeduren verwalten Tablespaces für Amazon RDS for Db2-Datenbanken. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung zur Datenbank herstellen. rdsadmin

rdsadmin.create_tablespace

Erzeugt einen 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')"

Parameter

Die folgenden Parameter sind erforderlich:

database_name

Der Name der Datenbank, in der der Tablespace erstellt werden soll. Der Datentyp istvarchar.

tablespace_name

Der Name des zu erstellenden Tablespaces. Der Datentyp istvarchar.

Für den Tablespace-Namen gelten die folgenden Einschränkungen:

  • Er darf nicht mit dem Namen eines vorhandenen Tablespaces in dieser Datenbank identisch sein.

  • Er kann nur die Zeichen _$#@a-zA-Z0-9 enthalten.

  • Es kann nicht mit _ oder beginnen$.

  • Es kann nicht beginnen mitSYS.

Die folgenden Parameter sind optional:

buffer_pool_name

Der Name des Pufferpools, dem der Tablespace zugewiesen werden soll. Der Datentyp istvarchar. Der Standardwert ist eine leere Zeichenfolge.

Wichtig

Sie müssen bereits über einen Pufferpool mit derselben Seitengröße verfügen, der dem Tablespace zugeordnet werden kann.

tablespace_page_size

Die Seitengröße des Tablespaces in Byte. Der Datentyp istinteger. Zulässige Werte: 4096, 8192, 16384, 32768. Die Standardeinstellung ist die Seitengröße, die verwendet wurde, als Sie die Datenbank durch Aufrufen erstellt habenrdsadmin.create_database.

Wichtig

Amazon RDS unterstützt Schreibatomizitä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 abgebrochen werden oder dass unvollständige Daten auf den Schreibtisch geschrieben werden. Wenn Sie Seiten mit 32 KiB verwenden, empfehlen wir Ihnen, die point-in-time Wiederherstellung und automatische Backups zu aktivieren. Andernfalls laufen Sie Gefahr, dass Sie zerrissene Seiten nicht wiederherstellen können. Weitere Informationen erhalten Sie unter Einführung in Backups und Wiederherstellung einer DB-Instance zu einem bestimmten Zeitpunkt für Amazon RDS.

tablespace_initial_size

Die ursprüngliche Größ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 angeben, legt Db2 einen geeigneten Wert für Sie fest.

Anmerkung

Dieser Parameter gilt nicht für temporäre Tablespaces, da das System temporäre Tablespaces verwaltet.

tablespace_increase_size

Der Prozentsatz, um den der Tablespace erhöht werden soll, wenn er voll ist. Der Datentyp istinteger. Gültige Werte: 1 —100. Der Standardwert ist „null“.

Wenn Sie keinen Wert angeben, legt Db2 einen geeigneten Wert für Sie fest.

Anmerkung

Dieser Parameter gilt nicht für temporäre Tablespaces, da das System temporäre Tablespaces verwaltet.

tablespace_type

Der Typ des Tablespaces. Der Datentyp istchar. Gültige Werte: U (für Benutzerdaten), T (für temporäre Benutzerdaten) oder S (für temporäre Systemdaten). Der Standardwert ist U.

Nutzungshinweise

RDSfür Db2 wird immer eine große Datenbank für Daten erstellt.

Hinweise zur Überprüfung des Status beim Erstellen eines Tablespaces finden Sie unter. rdsadmin.get_task_status

Beispiele

Das folgende Beispiel erstellt einen Tablespace namens SP8 und weist einen Pufferpool zu, der BP8 für eine Datenbank namens aufgerufen wird. TESTDB Der Tablespace hat eine anfängliche Tablespace-Seitengröße von 4.096 Byte, einen anfänglichen Tablespace von 1.000 KB und eine Erhöhung der Tabellengröße ist auf 50% festgelegt.

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    'BP8',
    4096,
    1000,
    50)"

Im folgenden Beispiel wird ein temporärer Tablespace namens erstellt. SP8 Es weist einer BP8 aufgerufenen Datenbank einen Pufferpool mit einer Größe von 8 KiB zu. TESTDB

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    'BP8', 
    8192, 
    NULL, 
    NULL, 
    'T')"

rdsadmin.alter_tablespace

Ändert einen 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')"

Parameter

Die folgenden Parameter sind erforderlich:

database_name

Der Name der Datenbank, die den Tablespace verwendet. Der Datentyp istvarchar.

tablespace_name

Der Name des Tablespaces, der geändert werden soll. Der Datentyp istvarchar.

Die folgenden Parameter sind optional:

buffer_pool_name

Der Name des Pufferpools, dem der Tablespace zugewiesen werden soll. Der Datentyp istvarchar. Der Standardwert ist eine leere Zeichenfolge.

Wichtig

Sie müssen bereits über einen Pufferpool mit derselben Seitengröße verfügen, der dem Tablespace zugeordnet werden kann.

tablespace_increase_size

Der Prozentsatz, um den der Tablespace vergrößert werden soll, wenn er voll ist. Der Datentyp istinteger. Gültige Werte: 1 —100. Der Standardwert ist 0.

max_size

Die maximale Größe für den Tablespace. Der Datentyp istvarchar. Zulässige Werte: integer K| M |G, oderNONE. Der Standardwert ist NONE.

reduce_max

Gibt an, ob der Höchstwert des Grenzwerts erreicht werden soll. Der Datentyp istchar. Der Standardwert ist N.

reduce_stop

Gibt an, ob ein vorhergehender reduce_value Befehl reduce_max oder ein Befehl unterbrochen werden soll. Der Datentyp istchar. Der Standardwert ist N.

reduce_value

Die Zahl oder der Prozentsatz, um den die Höchstwassermarke im Tablespace reduziert werden soll. Der Datentyp istvarchar. Zulässige Werte: integer K| M |G, oder 1 —100. Der Standardwert ist N.

lower_high_water

Gibt an, ob der ALTER TABLESPACE LOWER HIGH WATER MARK Befehl ausgeführt werden soll. Der Datentyp istchar. Der Standardwert ist N.

lower_high_water_stop

Gibt an, ob der ALTER TABLESPACE LOWER HIGH WATER MARK STOP Befehl ausgeführt werden soll. Der Datentyp istchar. Der Standardwert ist N.

switch_online

Gibt an, ob der ALTER TABLESPACE SWITCH ONLINE Befehl ausgeführt werden soll. Der Datentyp istchar. Der Standardwert ist N.

Nutzungshinweise

Die optionalen Parameterreduce_max,reduce_stop, reduce_value lower_high_waterlower_high_water_stop, und schließen switch_online sich gegenseitig aus. Sie können sie nicht mit anderen optionalen Parametern kombinierenbuffer_pool_name, z. B. im rdsadmin.alter_tablespace Befehl. Wenn Sie diese Parameter mit einem anderen optionalen Parameter im rdsadmin.alter_tablespace Befehl kombinieren, gibt Db2 bei der Ausführung rdsadmin.get_task_status einen Fehler wie den folgenden zurück:

DB21034E  The command was processed as an SQL statement because it was not a valid Command Line Processor command.  During SQL processing it returned:
SQL1763N  Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"

Hinweise zur Überprüfung des Status der Änderung eines Tablespaces finden Sie unter. rdsadmin.get_task_status

Beispiele

Im folgenden Beispiel wird ein aufgerufener Tablespace geändert SP8 und ein Pufferpool zugewiesen, der BP8 für eine Datenbank aufgerufen wird, die aufgerufen wurde, um den TESTDB Höchstwert zu senken.

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'SP8',
    'BP8', 
    NULL, 
    NULL, 
    'Y')"

Im folgenden Beispiel wird der REDUCE MAX Befehl für einen Tablespace ausgeführt, der TBSP_TEST in der Datenbank aufgerufen wird. TESTDB

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'TBSP_TEST',
    NULL,
    NULL,
    NULL,
    'Y')"

Im folgenden Beispiel wird der REDUCE STOP Befehl in einem Tablespace ausgeführt, der TBSP_TEST in der Datenbank aufgerufen wird. TESTDB 

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'TBSP_TEST',
    NULL,
    NULL,
    NULL,
    NULL,
    'Y')"

rdsadmin.rename_tablespace

Benennt einen Tablespace um.

Syntax

db2 "call rdsadmin.rename_tablespace(
    ?,
    'database_name', 
    'source_tablespace_name',
    'target_tablespace_name')"

Parameter

Die folgenden Parameter sind erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

database_name

Der Name der Datenbank, zu der der Tablespace gehört. Der Datentyp istvarchar.

source_tablespace_name

Der Name des Tablespaces, der umbenannt werden soll. Der Datentyp istvarchar.

target_tablespace_name

Der neue Name des Tablespaces. Der Datentyp istvarchar.

Der neue Name hat die folgenden Einschränkungen:

  • Er darf nicht mit dem Namen eines vorhandenen Tablespaces identisch sein.

  • Er kann nur die Zeichen _$#@a-zA-Z0-9 enthalten.

  • Es kann nicht mit _ oder beginnen$.

  • Es kann nicht beginnen mitSYS.

Nutzungshinweise

Hinweise zur Überprüfung des Status beim Umbenennen eines Tablespaces finden Sie unter. rdsadmin.get_task_status

Sie können Tablespaces, die zur Datenbank gehören, nicht umbenennen. rdsadmin

Beispiele

Im folgenden Beispiel wird ein aufgerufener Tablespace SP9 in einer Datenbank mit SP8 dem Namen umbenannt. TESTDB

db2 "call rdsadmin.rename_tablespace(
    ?,
    'TESTDB',
    'SP8'.
    'SP9')"

rdsadmin.drop_tablespace

Löscht einen Tablespace.

Syntax

db2 "call rdsadmin.drop_tablespace(
    'database_name', 
    'tablespace_name')"

Parameter

Die folgenden Parameter sind erforderlich:

database_name

Der Name der Datenbank, zu der der Tablespace gehört. Der Datentyp istvarchar.

tablespace_name

Der Name des Tablespaces, der gelöscht werden soll. Der Datentyp istvarchar.

Nutzungshinweise

Hinweise zur Überprüfung des Status beim Löschen eines Tablespaces finden Sie unterrdsadmin.get_task_status.

Beispiele

Im folgenden Beispiel wird ein Tablespace gelöscht, der SP8 aus einer Datenbank namens aufgerufen wurde. TESTDB

db2 "call rdsadmin.drop_tablespace(
    'TESTDB',
    'SP8')"