ALTER LOCATION

説明

このステートメントは、Locationオブジェクトのプロパティを変更するために使用されます。

権限要件

• 実行権限：

  ALTER LOCATION ステートメントを実行するには、現在のユーザーが CREATE LOCATION 権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、MySQLモードの権限分類を参照してください。

• 認証資格権限：

  提供された 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内のディレクトリパスを指します。

• オブジェクトストレージ（OSS/S3）パスの形式：URL = '{oss | s3}://bucket/remote_file_path'。

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

関連ドキュメント

Locationオブジェクト配下のファイルの情報を確認する方法については、SHOWを参照してください。