ALTER LOCATION

描述

该语句用于修改 Location 对象属性。

权限要求

• 执行权限：

  执行 ALTER LOCATION 语句，需要当前用户拥有 CREATE LOCATION 权限。有关 OceanBase Database AI 权限的详细介绍，参见 权限分类。

• 认证凭据权限：

  提供的 ACCESSID 和 ACCESSKEY 需具备目标存储服务的合法访问权限。

语法

ALTER LOCATION location_name SET 
    {URL = 'file_path'
    | CREDENTIAL = (credential_list)
    };

credential_list:
    ACCESSID = 'string'
    ACCESSKEY = 'string'
    HOST = 'string'
    [S3_REGION = 'string']
    [PRINCIPAL = 'string']
    [KEYTAB = 'string']
    [KRB5CONF = 'string']
    [CONFIGS = 'string']
    [USERNAME = 'string']

参数说明

file_path

外表文件存放的路径有以下格式：

• 本地路径格式为：URL = 'file://local_file_path'，其中 local_file_path 可以为相对路径，也可以为绝对路径。

• HDFS 路径格式为：URL = 'hdfs://localhost:port/PATH'，其中 localhost 指的是 HDFS 的地址，port 指的是 HDFS 的端口号，PATH 指 HDFS 中的目录路径。

• 对象存储（S3）路径格式为：URL = 's3://bucket/remote_file_path'。

• 当前版本暂时兼容存量 oss:// 格式的路径（历史元数据中的地址可正常解析），新建对象存储位置时请使用 s3://，后续版本可能移除兼容；如果存量配置中的 host 仍为原生 OSS endpoint，需同步改为 S3 兼容 endpoint。

credential_list

• ACCESSID：用于修改访问对象存储的用户 AccessKey ID。
• ACCESSKEY：用于修改访问对象存储的用户 AccessKey Secret。
• HOST：用于修改对象存储服务的主机地址。
• S3_REGION：可选项，用于修改 S3 对象存储的服务区域。
• PRINCIPAL：可选项，目标 HDFS 集群带 kerberos 环境时，用于修改登录认证用户。
• KEYTAB：可选项，目标 HDFS 集群带 kerberos 环境时，用于修改认证密钥文件路径。
• KRB5CONF：可选项，目标 HDFS 集群带 kerberos 环境时，用于修改用户使用 kerberos 环境的文件路径。
• CONFIGS：可选项，目标 HDFS 集群带 kerberos 环境时，用于修改额外的集群配置项。
• USERNAME：可选项，目标 HDFS 集群带 Kerberos 环境时，用于修改唯一标识用户身份。

示例

修改 Location 对象 test_location_oss 的 CREDENTIAL 信息。

obclient> CREATE LOCATION test_location_oss
    URL = 's3://dir'
    CREDENTIAL = (
        ACCESSID = '******'
        ACCESSKEY = '******'
        HOST = '******'
        );

相关文档

关于查看 Location 对象下文件的介绍信息，参见 SHOW。