container-registry.oracle.com/database/adb-free:25.5.4.2

使用此镜像

数据库版本

从https://github.com/oracle/adb-free/pkgs/container/adb-free%E4%B8%AD%EF%BC%8C%E9%80%89%E6%8B%A9%E6%95%B0%E6%8D%AE%E5%BA%93%E7%89%88%E6%9C%AC%E5%8F%8A%E5%AF%B9%E5%BA%94%E7%9A%84%E9%95%9C%E5%83%8F%E3%80%82%E6%88%91%E4%BB%AC%E4%BD%BF%E7%94%A8%E4%BB%A5%E4%B8%8B%E5%91%BD%E5%90%8D%E7%BA%A6%E5%AE%9A%EF%BC%9A

[!NOTE] ADBS-25.9.3.2-23ai 是最后一个 23ai 版本。我们现在仅发布 26ai 和 19c 的 adb-free 镜像。

[!NOTE] 通常，镜像除了发布版本标签外，还会有额外的"重要功能"标签。例如：adb-free:select_ai_agent

容器CPU/内存要求

Oracle Autonomous AI Database Free 容器需要 4 个 CPU 和 8 GiB 内存

安装podman

请参考官方文档在Linux、Windows或Mac上安装 podman

在MacOS或Windows上启动podman机器

容器需要Linux内核。运行以下命令启动podman虚拟机：

podman machine init
podman machine set --cpus 4 --memory 8192
podman machine start

[!NOTE] 26ai 镜像是多架构的，即原生支持 ARM64 和 AMD64 平台。 19c 镜像仅原生支持 linux/amd64 平台。要在 ARM 机器上运行 19c adb-free 容器，需要使用 colima 模拟。 有关设置 Colima 虚拟机的说明，请阅读FAQ

启动ADB Free容器

[!NOTE] 尽管说明中使用 podman，但镜像格式同时符合开放容器倡议 (OCI) 和 Docker 标准。 ADB 容器可与 OCI 和 Docker 容器运行时无缝协作。您也可以使用 docker 启动容器。

要启动用于ATP工作负载的 Oracle Autonomous AI Database Free 容器，请运行以下命令：

podman run -d \
  -p 1521:1522 \
  -p 1522:1522 \
  -p 8443:8443 \
  -p 27017:27017 \
  -e WORKLOAD_TYPE=ATP \
  -e WALLET_PASSWORD=*** \
  -e ADMIN_PASSWORD=*** \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  --name adb-free \
  container-registry.oracle.com/database/adb-free:latest-26ai

注意：对于 19c，请使用 container-registry.oracle.com/database/adb-free:latest

容器首次启动时：

• 必须更改管理员密码。请使用环境变量 ADMIN_PASSWORD 指定密码
• 使用密码 WALLET_PASSWORD 生成

下表解释传递给容器的环境变量：

注意：对于 OFS 挂载，容器应使用 SYS_ADMIN 权限启动。此外，虚拟设备 /dev/fuse 必须可访问

端口

请注意以下转发到容器进程的端口：

HTTP代理

如果您位于企业代理之后，有两种方式配置数据库使用代理设置：

1. 设置 HTTP_PROXY 数据库属性。供 DBMS_CLOUD 等包使用：

exec DBMS_CLOUD_CONTAINER_ADMIN.set_database_property('HTTP_PROXY', 'www-my-corp-proxy.com:80/');

2. 使用 UTL_HTTP.set_proxy 为通过 UTL_HTTP 发送的 HTTP 请求设置代理：

exec UTL_HTTP.SET_PROXY('www-my-corp-proxy.com');

adb-cli

adb-cli 可用于在容器启动并运行后执行数据库操作。

要使用 adb-cli，您可以定义以下别名以方便使用：

alias adb-cli="podman exec adb-cli"

可用命令

>> adb-cli --help
Usage: adb-cli [OPTIONS] COMMAND [ARGS]...

  ADB-S Command Line Interface (CLI) to perform container-runtime database operations

Options:
  -v, --version  Show the version and exit.
  --help         Show this message and exit.

Commands:
  add-database   添加数据库
  change-password  修改密码

添加数据库

您可以使用 add-database 命令添加数据库：

adb-cli add-database --workload-type "ADW" --admin-password "Welcome_1234"

修改密码

要修改管理员用户密码，请使用以下命令：

adb-cli change-password --database-name "MYADW" --old-password "Welcome_1234" --new-password "Welcome_12345"

跨容器迁移数据

挂载卷

要在容器重启和删除后持久化数据，应在 /u01/data 挂载卷，并按照跨容器迁移PDB数据的文档中提到的步骤操作：

podman run -d \
  -p 1521:1522 \
  -p 1522:1522 \
  -p 8443:8443 \
  -p 27017:27017 \
  -e WORKLOAD_TYPE=ATP \
  -e WALLET_PASSWORD=*** \
  -e ADMIN_PASSWORD=*** \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  --name adb-free \
  --volume adb_container_volume:/u01/data \
  container-registry.oracle.com/database/adb-free:latest-26ai

连接到Oracle Autonomous AI Database Free容器

ORDS/APEX/Database Actions

容器主机名用于生成自签名SSL证书，以在8443端口提供HTTPS流量。可使用容器主机（或直接使用localhost）访问APEX和Database Actions：

注意：对于使用 adb-cli add-database 命令插入的其他数据库，请分别使用 URL 格式 https://localhost:8443/ords/{database_name}/apex 和 https://localhost:8443/ords/{database_name}/sql-developer 访问 APEX 和 Database Actions。

***设置

在容器中，TLS***生成于 /u01/app/oracle/wallets/tls_wallet 位置。

将***复制到主机：

podman cp adb-free:/u01/app/oracle/wallets/tls_wallet /scratch/tls_wallet

在此示例中，***被复制到 /scratch/tls_wallet 文件夹。

将 TNS_ADMIN 环境变量指向***目录：

export TNS_ADMIN=/scratch/tls_wallet

如果要连接到运行ADB free容器的远程主机，请将 $TNS_ADMIN/tnsnames.ora 中的 localhost 替换为远程主机的FQDN：

sed -i 's/localhost/my.host.com/g' $TNS_ADMIN/tnsnames.ora

可用TNS别名

与云中的Autonomous AI Database类似，可使用以下任一别名连接到ADB free容器。

MYATP TNS别名

对于mTLS，使用以下别名：

• myatp_medium
• myatp_high
• myatp_low
• myatp_tp
• myatp_tpurgent

对于TLS，使用以下别名：

• myatp_medium_tls
• myatp_high_tls
• myatp_low_tls
• myatp_tp_tls
• myatp_tpurgent_tls

MYADW TNS别名

对于mTLS，使用以下别名：

• myadw_medium
• myadw_high
• myadw_low

对于TLS，使用以下别名：

• myadw_medium_tls
• myadw_high_tls
• myadw_low_tls

TNS别名与其连接字符串的映射可在 $TNS_ADMIN/tnsnames.ora 文件中找到。

TLS无***连接

要无***连接，需要使用容器启动时生成的自签名证书更新客户端的信任库。

Linux系统信任库

从容器复制 /u01/app/oracle/wallets/tls_wallet/adb_container.cert 并更新系统信任库：

podman cp adb-free:/u01/app/oracle/wallets/tls_wallet/adb_container.cert adb_container.cert
sudo cp adb_container.cert /etc/pki/ca-trust/source/anchors
sudo update-ca-trust

MacOS系统信任库

对于MacOS，请参考支持指南将证书添加到钥匙串。

JDK信任库

要更新JDK信任库，可使用 keytool：

Linux示例：

sudo keytool -import -alias adb_container_certificate -keystore $JAVA_HOME/lib/security/cacerts -file adb_container.cert

MacOS示例：

sudo keytool -import -alias adb_container_certificate -file adb_container.cert -keystore /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/lib/security/cacerts

SQL Developer桌面应用

从容器复制***并压缩：

podman cp adb-free:/u01/app/oracle/wallets/tls_wallet /scratch/tls_wallet
zip -j /scratch/tls_wallet.zip /scratch/tls_wallet/*

压缩***后，打开SQLDeveloper并按照以下步骤操作：

1. 点击文件 -> 新建 -> 数据库连接
2. 输入用户名/密码
3. 从"连接类型"下拉菜单中选择"Cloud Wallet"
4. 在"配置文件"下浏览到wallet.zip的路径
5. 从下拉菜单中选择服务
6. 点击连接

SQL*Plus

在此示例中，我们使用别名 myatp_low 连接：

sqlplus admin/<password>@myatp_low

SQL*Plus: Release 21.0.0.0.0 - Production on Wed Jul 26 22:38:27 2023
Version 21.9.0.0.0

Copyright (c) 1982, 2022, Oracle.  All rights reserved.

Last Successful login time: Wed Jul 26 2023 16:36:16 +00:00

Connected to:
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.20.0.1.0

SQL>

Python

安装Oracle数据库的python-oracledb驱动：

python3 -m pip install oracledb

import oracledb

conn = oracledb.connect(
    user="admin",
    password="<password>",
    dsn="myadw_medium",
    config_dir="/scratch/tls_wallet",
    wallet_location="/scratch/tls_wallet",
    wallet_password="***"
)
cr = conn.cursor()
r = cr.execute("SELECT 1 FROM DUAL")
print(r.fetchall())
>> [(1,)]

创建应用用户

以管理员身份连接：

sqlplus admin/<password>@myatp_medium

按如下方式创建用户：

CREATE USER APP_USER IDENTIFIED BY "<password>" QUOTA UNLIMITED ON DATA;

-- 添加角色
GRANT CONNECT TO APP_USER;
GRANT CONSOLE_DEVELOPER TO APP_USER;
GRANT DWROLE TO APP_USER;
GRANT RESOURCE TO APP_USER;

-- 启用REST
BEGIN
  ORDS.ENABLE_SCHEMA(
    p_enabled => TRUE,
    p_schema => 'APP_USER',
    p_url_mapping_type => 'BASE_PATH',
    p_url_mapping_pattern => 'app_user',
    p_auto_rest_auth=> TRUE
  );
  commit;
END;
/

-- 配额
ALTER USER APP_USER QUOTA UNLIMITED ON DATA;

Oracle Estate Explorer (OEE)

Oracle Estate Explorer 是一款工具，使客户能够以编程方式评估Oracle数据库组向Oracle Autonomous AI Database的迁移就绪性。OEE的输出提供测试数据库组的高级资产概述，根据其与ADB先决条件的对齐程度进行排名，并提供所需任何修复的分级相对工作量。OEE APEX应用已安装在adb-free镜像中，可供使用...