Spark SQL 指南

ALTER DATABASE

說明

ALTER DATABASE 陳述式會變更資料庫的屬性或位置。請注意，DATABASE、SCHEMA 和 NAMESPACE 的用法是可以互換的，可以互相取代。如果系統中找不到資料庫，會傳送錯誤訊息。

ALTER PROPERTIES

ALTER DATABASE SET DBPROPERTIES 陳述式會變更與資料庫相關聯的屬性。指定的屬性值會覆寫具有相同屬性名稱的任何現有值。此命令主要用於記錄資料庫的元資料，並可於稽核目的使用。

語法

ALTER { DATABASE | SCHEMA | NAMESPACE } database_name
    SET { DBPROPERTIES | PROPERTIES } ( property_name = property_value [ , ... ] )

參數

ALTER LOCATION

ALTER DATABASE SET LOCATION 陳述式會變更資料庫新增新資料表時預設的父目錄。請注意，它不會將資料庫目前目錄的內容移至新指定的目錄，也不會變更與指定資料庫下的任何資料表/分割區相關聯的位置（自 Spark 3.0.0 起可用，搭配 Hive metastore 版本 3.0.0 以上）。

語法

ALTER { DATABASE | SCHEMA | NAMESPACE } database_name
    SET LOCATION 'new_location'

參數

範例

-- Creates a database named `inventory`.
CREATE DATABASE inventory;

-- Alters the database to set properties `Edited-by` and `Edit-date`.
ALTER DATABASE inventory SET DBPROPERTIES ('Edited-by' = 'John', 'Edit-date' = '01/01/2001');

-- Verify that properties are set.
DESCRIBE DATABASE EXTENDED inventory;
+-------------------------+------------------------------------------+
|database_description_item|                database_description_value|
+-------------------------+------------------------------------------+
|            Database Name|                                 inventory|
|              Description|                                          |
|                 Location|   file:/temp/spark-warehouse/inventory.db|
|               Properties|((Edit-date,01/01/2001), (Edited-by,John))|
+-------------------------+------------------------------------------+

-- Alters the database to set a new location.
ALTER DATABASE inventory SET LOCATION 'file:/temp/spark-warehouse/new_inventory.db';

-- Verify that a new location is set.
DESCRIBE DATABASE EXTENDED inventory;
+-------------------------+-------------------------------------------+
|database_description_item|                 database_description_value|
+-------------------------+-------------------------------------------+
|            Database Name|                                  inventory|
|              Description|                                           |
|                 Location|file:/temp/spark-warehouse/new_inventory.db|
|               Properties| ((Edit-date,01/01/2001), (Edited-by,John))|
+-------------------------+-------------------------------------------+