Gespeicherte Prozeduren für Tablespaces für RDS for Db2 - 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 RDS for Db2

Die in diesem Thema beschriebenen integrierten 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

Diese gespeicherten Prozeduren werden für eine Vielzahl von Aufgaben verwendet. Diese Liste ist nicht umfassend.

Informationen zu deren Syntax, Parametern, Verwendungshinweisen und Beispielen finden Sie in den folgenden integrierten gespeicherten Prozeduren.

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',
    'tablespace_prefetch_size')"

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.

tablespace_prefetch_size

Die Prefetch-Seitengröße des Tablespaces. Der Datentyp ist. char Gültige Werte: AUTOMATIC (Groß- und Kleinschreibung wird nicht berücksichtigt) oder positive Ganzzahlen ungleich Null, die kleiner oder gleich 32767 sind.

Nutzungshinweise

RDS for Db2 erstellt immer eine große Datenbank für Daten.

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

Beispiele

Beispiel 1: Einen Tablespace erstellen und einen Pufferpool zuweisen

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)"

Beispiel 2: Einen temporären Tablespace erstellen und einen Pufferpool zuweisen

Das folgende Beispiel erstellt einen temporären Tablespace namens. 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')"

Beispiel 3: Einen Tablespace erstellen und eine Prefetch-Seitengröße zuweisen

Das folgende Beispiel erstellt einen Tablespace, der für eine Datenbank namens aufgerufen wirdSP8. TESTDB Der Tablespace hat eine anfängliche Tablespace-Größe von 50 und eine Prefetch-Seitengröße von. 800

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    NULL,
    NULL,
    NULL,
    50,
    NULL,
    '800')"

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',
    'tablespace_prefetch_size')"

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. Gültige Werte: integer K | M |G, oderNONE. Der Standardwert ist NONE.

reduce_max

Gibt an, ob der Höchstwert auf den Höchstwert reduziert 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. Gültige 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.

tablespace_prefetch_size

Die Prefetch-Seitengröße des Tablespaces. Der Datentyp ist. char Gültige Werte: AUTOMATIC (Groß- und Kleinschreibung wird nicht berücksichtigt) oder positive Ganzzahlen ungleich Null, die kleiner oder gleich 32767 sind.

Anmerkung

Dieser Parameter funktioniert nur mitbuffer_pool_name,, und. table_increase_size max_size switch_online Er funktioniert nicht mitreduce_max,reduce_stop, reduce_valuelower_high_water, undlower_high_water_stop.

Nutzungshinweise

Bevor Sie die gespeicherte Prozedur aufrufen, sollten Sie sich die folgenden Überlegungen ansehen:

  • Die rdsadmin.alter_tablespace gespeicherte Prozedur funktioniert nicht in einem Tablespace, in dem die tablespace_type Einstellung T für temporäre Benutzerdaten auf gesetzt ist.

  • 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. Weitere Informationen finden Sie unter Statement not valid.

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

Fehlermeldungen, die beim Aufrufen von gespeicherten Prozeduren zurückgegeben werden, finden Sie unter. Behebung von Fehlern bei gespeicherten Prozeduren

Beispiele

Beispiel 1: Senkung der Hochwassermarke

Im folgenden Beispiel wird ein Tablespace geändert, der aufgerufen wird, SP8 und es wird ein Pufferpool zugewiesen, der BP8 für eine Datenbank aufgerufen wird, die aufgerufen wirdTESTDB, um den Grenzwert zu senken.

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

Beispiel 2: Reduzierung der Höchstwassermarke

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

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

Beispiel 3: Befehle werden unterbrochen, um den Wasserstand zu reduzieren

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

Beispiel 4: Ändern der vorhandenen Prefetch-Seitengröße

Im folgenden Beispiel wird der ALTER TABLESPACE SWITCH ONLINE Befehl für einen Tablespace ausgeführt, der aufgerufen wird, TSBP_TEST und die bestehende Prefetch-Seitengröße wird auf geändert. 64 

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

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.

Für den neuen Namen gelten 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')"