---
title: "ALTER LOCATION - OceanBase Database AI V4.6.2 | OceanBase 文档中心"
description: ALTER LOCATION 描述 该语句用于修改 Location 对象属性。 权限要求 执行权限： 执行 ALTER LOCATION 语句，需要当前用户拥有 CREATE LOCATION 权限。有关 OceanBase Database AI 权限的详细介绍，参见 权限分类 。 认证凭据权限： 提供的 ACC…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*inJjSpyNOjUAAAAAHtAAAAgAeiGDAQ/original) OceanBase Database AIV 4.6.2

# ALTER LOCATION

更新时间：2026-08-18 15:43:15

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.2/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/600.sql-statement-of-mysql-mode/1230.alter-location-of-mysql-mode-in-sql.md)  

## 描述

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

## 权限要求

- 执行权限：

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

  提供的 `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 中的目录路径。
 - 对象存储（S3）路径格式为：`URL = 's3://bucket/remote_file_path'`。
 - 当前版本暂时兼容存量 `oss://` 格式的路径（历史元数据中的地址可正常解析），新建对象存储位置时请使用 `s3://`，后续版本可能移除兼容；如果存量配置中的 `host` 仍为原生 OSS endpoint，需同步改为 S3 兼容 endpoint。

#### 注意

创建 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 = 's3://dir'
    CREDENTIAL = (
        ACCESSID = '******'
        ACCESSKEY = '******'
        HOST = '******'
        );

```

## 相关文档

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

 上一篇 下一篇 ![有帮助](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) 咨询热线