ÁTNEVEZÉS (Transact-SQL)

A következőkre vonatkozik:Azure Synapse AnalyticsAnalytics Platform System (PDW)

Átnevez egy felhasználó által létrehozott táblát az Azure Synapse Analytics-ben. Átnevezi a felhasználó által létrehozott táblát, egy oszlopot a felhasználó által létrehozott táblában vagy adatbázist az Analytics Platform Systemben (PDW).

Ez a cikk csak az Azure Synapse Analytics and Analytics Platform System (PDW) alkalmazására vonatkozik:

  • Egy adatbázis átnevezéséhez SQL Server-ben használjuk a sp_renamedb tárolt eljárást.
  • Az adatbázis átnevezéséhez az Azure SQL Database-ben használd aALTER DATABASE (Azure SQL Database) utasítást.
  • Az önálló, dedikált SQL poolok (korábban SQL DW) átnevezése támogatott. Egy dedikált SQL pool átnevezése az Azure Synapse Analytics workspace-ekben jelenleg nem támogatott.
  • Ezt a szintaxist az Azure Synapse Analytics kiszolgáló nélküli SQL-készlete nem támogatja.

Syntax

-- Syntax for Azure Synapse Analytics

-- Rename a table.
RENAME OBJECT [::] [ [ database_name . [schema_name ] ] . ] | [schema_name . ] ] table_name TO new_table_name
[;]

-- Syntax for Analytics Platform System (PDW) 

-- Rename a table
RENAME OBJECT [::] [ [ database_name . [ schema_name ] . ] | [ schema_name . ] ] table_name TO new_table_name
[;]

-- Rename a database
RENAME DATABASE [::] database_name TO new_database_name
[;]

-- Rename a column 
RENAME OBJECT [::] [ [ database_name . [schema_name ] ] . ] | [schema_name . ] ] table_name COLUMN column_name TO new_column_name [;]

Arguments

NEVEZD ÁT AZ OBJEKTUMOT [::] [ [database_name . [ schema_name ] . ] | [ schema_name . ] ] table_nameA new_table_name

A következőkre vonatkozik: Azure Synapse Analytics, Elemzési platformrendszer (PDW)

Változtasd meg egy felhasználó által definiált tábla nevét. Határozd meg az átnevezendő táblát egy-, két- vagy háromrészes névvel. Határozd meg az új tábla new_table_name egyrészes névként.

ÁTNEVEZNI DATABASE [::] [ database_nameÁT new_database_name ]

Vonatkozik a következőkre: Analitikai Platform System (PDW)

Változtasd meg egy felhasználó által definiált adatbázis nevét database_name-rőlnew_database_name-re. Nem nevezhetsz át egy adatbázist az alábbi Analytics Platform System (PDW) fenntartott adatbázisnevek egyikére:

  • master
  • model
  • msdb
  • tempdb
  • pdwtempdb1
  • pdwtempdb2
  • DWConfiguration
  • DWDiagnostics
  • DWQueue

NEVEZD ÁT AZ OBJEKTUMOT [::] [ [database_name . [ schema_name ] . ] | [ schema_name . ] ]table_name OSZLOP column_namenew_column_name

Vonatkozik a következőkre: Analitikai Platform System (PDW)

Változtasd meg egy oszlop nevét egy táblázatban.

Permissions

A parancs futtatásához ehhez az engedélyhez van szükséged:

  • MÓDOSÍTÁSI engedély az asztalon

Korlátozások és korlátozások

Nem lehet átnevezni külső táblát, indexeket vagy nézeteket

Nem lehet átnevezni külső táblát, indexeket vagy nézeteket. Átnevezés helyett eltávolíthatja a külső táblát, indexet vagy nézetet, majd újra létrehozhatja egy új névvel.

Nem lehet átnevezni egy használt táblát

Nem lehet átnevezni egy táblát vagy adatbázist, amíg az használatban van. Egy asztal átnevezéséhez kizárólagos zárolás szükséges. Ha a tábla használatban van, előfordulhat, hogy le kell zárnod azokat az üléseket, amelyek az asztalt használják. Egy alkalom lezárásához használhatod a KILL parancsot. Használd óvatosan a KILL (KILL) funkciót, mert amikor egy alekszülést véget vetnek, minden elkötelezetlen munkát visszavonnak. Az Azure Synapse Analytics sessions-i 'SID' prefix lesz. A KILL parancs behívásához add meg a 'SID'-et és a session számát. Ez a példa egy aktív vagy tétlen ülések listáját mutatja, majd lezárja a 'SID1234' ülést.

Oszlop korlátozásainak átnevezése

Nem lehet átnevezni egy oszlopot, amit a tábla eloszlásához használnak. Külső vagy ideiglenes táblák oszlopait sem lehet átnevezni.

Nézetek nem frissülnek

Adatbázis átnevezésekor a korábbi adatbázisnevet használó összes nézet érvénytelenné válik. Ez a viselkedés mind az adatbázison belül, mind azon kívüli nézetekre vonatkozik. Például, ha az értékesítési adatbázist átnevezik, egy olyan nézet, amely tartalmazza SELECT * FROM Sales.dbo.table1 , érvénytelenné válik. Ennek a problémának a megoldásához elkerülhetjük a háromrészes neveket a nézetekben, vagy frissítheted a nézeteket, hogy az új adatbázis nevet használják.

Tábla átnevezésekor a nézeteket nem frissítik az új tábla névre hivatkozni. Minden nézet, az adatbázison belül vagy kívül, amely a korábbi tábla nevére hivatkozik, érvénytelenné válik. Ennek a problémának a megoldásához frissítheted az egyes nézeteket, hogy az új táblanévre hivatkozz.

Oszlop átnevezésekor a nézetek nem frissülnek, így nem hivatkoznak az új oszlopnévre. A nézetek továbbra is a régi oszlopnevet jelenítik meg, amíg végre nem hajtanak rajtuk egy ALTER VIEW műveletet. Bizonyos esetekben a nézetek érvénytelenné válhatnak, ha ledobásra és újrateremtésre van szükség.

Zárolás

Egy tábla átnevezése közös zárolást igényel az DATABASE objektumon, egy közös zárolást az SCHEMA objektumon, és egy exkluzív zárat az asztalon.

Examples

A. Adatbázis átnevezése

Vonatkozik a következőkre: Csak Analytics Platform System (PDW)

Ez a példa átnevezi a felhasználó által definiált adatbázist AdWorks2-re.

-- Rename the user defined database AdWorks
RENAME DATABASE AdWorks to AdWorks2;

Tábla átnevezésekor minden táblához tartozó objektum és tulajdonság frissül, hogy az új tábla nevére hivatkozzon. Például a tábladefiníciók, indexek, korlátok és jogosultságok frissülnek. A nézetek nem frissülnek.

B. Tábla átnevezése

A következőkre vonatkozik: Azure Synapse Analytics, Elemzési platformrendszer (PDW)

Ez a példa átnevezi az Ügyfél táblát Customer1-re.

-- Rename the customer table
RENAME OBJECT Customer TO Customer1;

RENAME OBJECT mydb.dbo.Customer TO Customer1;

Tábla átnevezésekor minden táblához tartozó objektum és tulajdonság frissül, hogy az új tábla nevére hivatkozzon. Például a tábladefiníciók, indexek, korlátok és jogosultságok frissülnek. A nézetek nem frissülnek.

C. Áthelyezni egy táblázatot egy másik sémára

A következőkre vonatkozik: Azure Synapse Analytics, Elemzési platformrendszer (PDW)

Ha a szándékod az objektum másik sémájára való áthelyezése, használd ALTER SCHEMA. Például a következő állítás áthelyezi a táblázat elemet a szorzatsémából a dbo sémába.

ALTER SCHEMA dbo TRANSFER OBJECT::product.item;

D. Zárd le az üléseket egy tábla átnevezése előtt

A következőkre vonatkozik: Azure Synapse Analytics, Elemzési platformrendszer (PDW)

Nem lehet átnevezni egy táblát, amíg használatban van. Egy táblázat átnevezéséhez exkluzív zárolást igényel az asztalon. Ha a tábla használatban van, előfordulhat, hogy a tábla segítségével kell lezárnod a játékmenetet. Egy alkalom lezárásához használhatod a KILL parancsot. Használd óvatosan a KILL (KILL) funkciót, mert amikor egy alekszülést véget vetnek, minden elkötelezetlen munkát visszavonnak. Az Azure Synapse Analytics sessions-i 'SID' prefix lesz. A KILL parancs behívásához meg kell adnod a 'SID'-t és a session számot. Ez a példa egy aktív vagy tétlen ülések listáját mutatja, majd lezárja a 'SID1234' ülést.

-- View a list of the current sessions
SELECT session_id, login_name, status
FROM sys.dm_pdw_exec_sessions
WHERE status='Active' OR status='Idle';

-- Terminate a session using the session_id.
KILL 'SID1234';

E. Oszlop átnevezése

Vonatkozik a következőkre: Analitikai Platform System (PDW)

Ez a példa átnevezi az Ügyfél tábla FName oszlopát FirstName névre.

-- Rename the Fname column of the customer table
RENAME OBJECT::Customer COLUMN FName TO FirstName;

RENAME OBJECT mydb.dbo.Customer COLUMN FName TO FirstName;

Kapcsolódó tartalom

  • Last updated on