更新日期：2024年09月11日
psycopg2.connect()
功能描述
此方法创建新的数据库会话并返回新的connection 对象。
原型
conn=psycopg2.connect(dbname="test",user="postgres",password="secret",host="127.0.0.1",p
ort="5432")
参数
表8-62
psycopg2.connect 参数
关键字
参数说明
dbname
数据库名称
user
用户名
password
密码
host
数据库IP 地址，默认为UNIX socket 类型。
port
连接端口号，默认为5432。
sslmode
ssl 模式，ssl 连接时用。
sslcert
客户端证书路径，ssl 连接时用。
sslkey
客户端密钥路径，ssl 连接时用。
sslrootcert
根证书路径，ssl 连接时用。
返回值
connection 对象（连接GBase 8c 数据库实例的对象）。
示例
参见6.5.9 示例：常用操作。
使用 onpsm 实用程序可管理 GBase 8s 主存储管理器 目录、设备、锁定和对象。
先决条件：要运行 onpsm 实用程序，您必须是 root 用户或 gbasedbt，或者是 bargroup 组的
成员。
语法
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 178 -
目录选项
设备选项
对象选项
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 179 -
池选项
表 1. onpsm 实用程序目录选项
元素
用途
重要注意事项
- C check
检查存储管理器目录表，这些
表用于存储有关存储管理器
所管理的池和设备的元数据
此命令可识别有问题的文件。
- C check
-l
检查目录表时显示索引键
- C check
-n
指示存储管理器不修正发现
的错误
- C detail 显示有关存储管理器目录表
的详细信息
- C export 将 GBase 8s Primary
Storage Manager 目录表导
出到名
为 psm_catalog.exp 的目
录
- C import 将当前 GBase 8s Primary
Storage Manager 目录替换
为从 psm_catalog.exp 目
录中的文件重新创建的目录。
仅当发生系统问题、丢失当前目录以及需要
还原到导出的目录时，
才应导入目录。
如果
需要导入目录，请先运行 onpsm -C
init 命令，然后再运行onpsm -C
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 180 -
元素
用途
重要注意事项
import 命令。
- C init
删除存储管理器的目录表
- C
init
-d 删除文件设备中的存储管理
器目录表和备份对象
- C unlock 对存储管理器目录解锁
如果存储管理器因为发生故障而从备份或恢
复会话异常退出，那么存储管理器目录表可
能会保持锁定。如果目录表处于锁定状态，
您可以释放这些锁定。
-y
指定在删除目录表之前不要
求确认
表 2. onpsm 实用程序设备选项
元素
用途
重要注意事项
-D add
将设备添加到 -g 选项指定
的池中
在添加设备前，收集有关设备的信息。请
参阅收集有关文件目录和设备的信息。
-D del
除去设备：
如果使用 -g 选项，
将从 -g 选项指定的
池中除去设备，而保
留 GBase 8s Primary
Storage Manager 目录
中的设备对象。
如果使用 -d 选项，
将从所有池中除去设
备，并从该设备中的文
件系统中除去所有备份
对象
如果使用 -g 选项删除设备，可以根据
需要复原对象。
如果除去设备，存储管理器将无法向该设
备添加新对象。
-D list
显示系统中所有设备的列表
-D purge
从 GBase 8s Primary Storage
Manager 目录中除去缺少的存
储管理器对象
-D scan
扫描设备中的对象以验
证 GBase 8s Primary Storage
Manager 目录中是否存在这些
对象，以便可以根据需要复原这
如果命令无法向目录添加对象，此命令将
忽略缺少的文件。
要能够向目录添加缺少的对象，必须满足
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 181 -
元素
用途
重要注意事项
些对象
如果对象不在目录中，此命令将
向目录添加该对象。
以下条件：
该对象标识不能分配给存储管理器
中的其他任何对象。
文件不能重命名或重定位到设备内
部的其他目录中
该对象版本不能分配给存储管理器
中的其他任何对象。
-D update
修改有关设备的信息
如果要修改有关多个设备的信息，请针对
每个设备运行独立的命令。
path
设备（针对 TAPE 设备）或目录
（针对 FILE 设备）的全名和路
径
路径的格式必须适合设备连接到的操作系
统。
设备的名称在池中必须唯一。
您可以在多个池中包含相同的设备。
如果要删除、列出、清除、扫描或更新信
息，路径必须是现有设备的路径。
-b block_s
ize
（仅限磁带设备）向设备写入数
据前需要积累的数据的最小字
节数
块大小对于磁带设备是必需的。
-d
从所有池中删除池并删除备份
对象
块大小对于磁带设备是必需的。
-g pool_na
me
要将设备添加到的池，即
DBSPOOL、LOGPOOL 或 EXTPOOL
有关池的信息存储在 GBase 8s Primary
Storage Manager 目录中。
如果未提供池名称，命令将失败。
指定：
用于备份数据库空间、
Blob 空间和
智能大对象空间的 DBSPOOL
用于备份逻辑日志的 LOGPOOL
用作登台区域的 EXTPOOL，从中可
以将特定备份或备份生成移至永久
存储器或移至其他计算机上。
-l dev_def
_file.txt
从设备定义文件装入有关设备
的信息
-p priorit
y
设备的优先级，即 HIGHEST、
HIGH、LOW 或 READ-ONLY
存储管理器会先填满池中的高优先级设
备，然后再将数据放入该池中的低优先级
设备。 当存储管理器准备填充池时，如果
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 182 -
元素
用途
重要注意事项
高优先级设备繁忙，那么存储管理器会使
用低优先级设备。
池中只能有一个设备的优先级可以为
HIGHEST。
如果在同一池中多个设备具有相同的优先
级，存储管理器将确定要首先使用的设备。
设备变满时，存储管理器会将其优先级更
改为 READ-ONLY。 向设备添加更多空间
后，可以更改优先级。
-s size
（仅限磁带设备）设备的最大存
储容量（以千字节为单位）
该大小对于磁带设备是可选的。如果未指
定大小，或指定为 0，那么存储管理器会
将大小解释为无限制。当大小为无限制时，
只有设备返回错误以指定设备已满时，才
会将设备视为已满。
要指定大小，请输入大小的数字值，后跟
后缀 B、K、M、G、T 或 P（分别表示字节、
千字节、兆字节、千兆字节、太字节或皮
特字节）。后缀可以是大写，也可以是小
写。
- t type
设备的类型，可以是 FILE 或
TAPE
有关设备的信息存储在 GBase 8s
Primary Storage Manager 目录中。
-u
将有关设备的信息卸载到设备
定义文件
设备定义文件是一个具有特定格式的文本
文件。使用装入选项运行 onpsm命令时，
存储管理器会使用该文件重新创建信息。
-y
指定不要求确认完成请求的操
作
表 3. onpsm 对象选项
元素
用途
重要注意事项
-O del
从池删除物理对象
-O detail
显示有关指定对象的详细信
息。详细信息包括对象的位
置。
-O dump
将对象数据抽取到当前目录
中的某个文件
- o object_id 标识特定对象
可以使用单一命令来删除或转储一个或多
个对象，如用途中所示。
-O list
显示池中的所有对象
对于每个对象，该列表包含创建对象的日
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 183 -
元素
用途
重要注意事项
期和时间、对象的大小和对象的路径名。
-y
指定不要求确认完成请求的
操作。
表 4. onpsm 池选项
元素
用途
重要注意事项
-P
add pool_name
添加新池
P
del pool_name
删除指定的池
-P list
列出系统中的所有池
-y
指定不要求确认完成请求的
操作。
表 5. onpsm 实用程序一般选项
元素
用途
重要注意事项
-h
显示帮助信息
-V
显示软件版本号和序列号
有关标准 GBase
8s -V 和 -version 选项的更多详细
信息，请参阅《GBase
8s 管理员参考》中的
获取实用程序的版本信息。
-version
显示软件版本号、序列号和其
他信息，
例如主机、
操作系统、
构建日期和 Global Language
Support (GLS) 版本
有关标准 GBase
8s -V 和 -version 选项的更多详细
信息，请参阅《GBase
8s 管理员参考》中的
获取实用程序的版本信息。
-version
all
显示 onpsm 版本信息和有
关 PSM 共享库的信息
用途
当您运行 onpsm 命令来定义设备时，如果不存在存储管理器目录，那么存储管理器会自动
创建这些目录。
存储管理器的缺省设备为 $GBASEDBTDIR/backups。此低优先级设备在创建目录时会自动
创建。您可以除去缺省设备。
创建设备时，如果该设备的目录不存在，存储管理器将自动创建该目录。存储管理器将使
用 onpsm -D add 命令中指定的目录路径。
可以使用单一命令来删除一个或多个对象，例如，通过运行以下格式的命令：
onpsm _O del -o obj_1 -o obj_2
还可以使用单一命令来转储一个或多个对象，例如，通过运行以下格式的命令：
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 184 -
onpsm _O dump -o obj_1 -o obj_2
如果不需要数据，请运行 onsmsync 实用程序来从 GBase 8s Primary Storage Manager 删除备
份对象。
有些第三方存储管理器不允许 onsmsync 实用程序从存储管理器删除备份对象。
如果您有第
三方存储管理器，那么可能需要手动删除不再需要的备份对象。
示例
以下命令在 DBSPOOL 池中添加路径名为 $INFOMRIXDIR/backups 的文件设备：
onpsm -D add $GBASEDBTDIR/backups -g DBSPOOL -t FILE -p HIGH
以下命令检查 GBase 8s Primary Storage Manager 目录表，并指示存储管理器不修正检查期
间发现的任何错误：
onpsm -C check -n
以下命令列出池中的对象，包含创建对象的日期和时间、对象的大小和对象的路径名。
onpsm -O list