---
title: "ALTER LOCATION - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: ALTER LOCATION 描述 该语句用于修改 Location 对象属性。 说明 对于 OceanBase 数据库 V4.4.x 版本，从 V4.4.1 版本开始支持 ALTER LOCATION 语句。 权限要求 执行权限： 执行 ALTER LOCATION 语句，需要当前用户拥有 CREATE LOCAT…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# ALTER LOCATION

更新时间：2026-04-11 16:18:29

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/500.sql-reference/100.sql-syntax/300.common-tenant-of-oracle-mode/900.sql-statement-of-oracle-mode/100.ddl-of-oracle-mode/230.alter-location-of-oracle-mode.md)  

## 描述

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

#### 说明

对于 OceanBase 数据库 V4.4.x 版本，从 V4.4.1 版本开始支持 `ALTER LOCATION` 语句。

## 权限要求

- 执行权限：

  执行 `ALTER LOCATION` 语句，需要当前用户拥有 `CREATE LOCATION` 权限。有关 OceanBase 数据库权限的详细介绍，参见 [Oracle 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004479235)。
 - 认证凭据权限：

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

## 语法

```sql
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']

```

## 参数说明

| **参数** | **描述** |
| --- | --- |
| location_name | 表示要修改的 Location 对象的名称。 |
| URL = 'file_path' | 用于修改外部存储路径。详细介绍可参见下文 [file_path](#file_path)。 |
| CREDENTIAL | 用于修改 HDFS 或对象存储访问路径所需的信息。详细介绍可参见下文 [credential_list](#credential_list)。 |

### file_path

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

- 本地路径格式为：`URL = 'file://local_file_path'`，其中 `local_file_path` 可以为相对路径，也可以为绝对路径。
 - HDFS 路径格式为：`URL = 'hdfs://localhost:port/PATH'`，其中 `localhost` 指的是 HDFS 的地址，`port` 指的是 HDFS 的端口号，`PATH` 指 HDFS 中的目录路径。
 - 对象存储（OSS/S3）路径格式为：`URL = '{oss | s3}://bucket/remote_file_path'`。

#### 注意

创建 Location 对象的路径中不应该带有参数。

### 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` 信息。

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

```

## 相关文档

关于查看 Location 对象下文件的介绍信息，参见 [SHOW](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004480974)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线