YENIDEN ADLANDIRMA (Transact-SQL)

Şunlar için geçerlidir: Azure Synapse AnalyticsAnalytics Platform Sistemi (PDW)

Azure Synapse Analytics'te kullanıcı tarafından oluşturulan bir tabloyu yeniden adlandır. Analitik Platform Sistemi (PDW)'de kullanıcı tarafından oluşturulan bir tablo veya veritabanındaki bir sütun olan bir kullanıcı tarafından oluşturulan bir tabloyu yeniden adlandırır.

Bu makale yalnızca Azure Synapse Analytics ve Analytics Platform System (PDW) için geçerlidir:

  • SQL Server içinde bir veritabanını yeniden adlandırmak için sp_renamedb adlı kayıtlı prosedürü kullanın.
  • Azure SQL Veritabanı'de bir veritabanını yeniden adlandırmak için (Azure SQL Veritabanı) ifadesini kullanınALTER DATABASE.
  • Bağımsız ayrılmış SQL havuzlarının (eski adıyla SQL DW) yeniden adlandırılması desteklenmektedir. Azure Synapse Analytics workspaces'te özel bir SQL havuzunun yeniden adlandırılması şu anda desteklenmiyor.
  • Bu söz dizimi, Azure Synapse Analytics'teki sunucusuz SQL havuzu tarafından desteklenmez.

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

NESNEYE YENIDEN ADLANDIRIN [::] [ [database_name . [ schema_name ] . ] | [ schema_name . ] ] table_nameTO new_table_name

Şunlar için geçerlidir: Azure Synapse Analytics, Analiz Platformu Sistemi (PDW)

Kullanıcı tanımlı bir tablonun adını değiştirin. Yeniden adlandırılacak tabloyu bir, iki veya üç parçalı bir isimle belirtin. Yeni tablo new_table_name tek parçalı bir isim olarak belirtin.

ADINI DATABASE DEĞIŞTIR [::] [ database_nameOLARAK new_database_name

Şunlar için geçerlidir: Analitik Platform Sistemi (PDW)

Kullanıcı tanımlı bir veritabanının adını database_name'dennew_database_name'ye değiştirin. Bir veritabanını, aşağıdaki Analytics Platform System (PDW) ayrılmış veritabanı isimlerinden herhangi birine yeniden adlandıramazsınız:

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

NESNEYE YENIDEN ADLANDIRIN [::] [ [database_name . [ schema_name ] . ] | [ schema_name . ] ]table_nameSÜTUN column_nameTO new_column_name

Şunlar için geçerlidir: Analitik Platform Sistemi (PDW)

Bir tablodaki sütunun adını değiştirin.

Permissions

Bu komutu çalıştırmak için şu izne ihtiyacınız var:

  • Masada ALTER izni

Sınırlamalar ve Kısıtlamalar

Harici bir tablo, indeks veya görünüm yeniden adlandırılamıyor

Harici bir tablo, indeks veya görünüm yeniden adlandıramazsınız. Yeniden adlandırmak yerine dış tabloyu, dizini veya görünümü bırakabilir, sonra da yeni adla yeniden oluşturabilirsiniz.

Kullanılan bir tablonun adını değiştiremiyorum

Bir tablo veya veritabanı kullanılırken yeniden adlandıramazsınız. Bir masanın adını değiştirmek için masada özel bir kilit gerekir. Tablo kullanılıyorsa, tabloyu kullanan oturumları sonlandırmanız gerekebilir. Bir oturumu sonlandırmak için KILL komutunu kullanabilirsiniz. KILL (ÖLDÜRME) dikkatli kullanın çünkü bir oturum sona erdiğinde taahhüt edilmemiş işler geri alınır. Azure Synapse Analytics içindeki oturumlar 'SID' ile prefikslenir. KILL komutunu çağırırken 'SID' ve oturum numarasını ekleyin. Bu örnek, aktif veya boşta oturumların listesini gösterir ve ardından oturum 'SID1234' sonlandırır.

Sütun kısıtlamalarını yeniden adlandırma

Tablonun dağıtımı için kullanılan bir sütunun adını değiştiremezsiniz. Ayrıca harici tabloda veya geçici tabloda hiçbir sütunun adını değiştiremezsiniz.

Görüşler güncellenmiyor

Veritabanı yeniden adlandırıldığında, eski veritabanı adını kullanan tüm görünümler geçersiz olur. Bu davranış hem veritabanı içindeki hem de dışındaki görünümler için geçerlidir. Örneğin, Satış veritabanı yeniden adlandırılırsa, içeriği SELECT * FROM Sales.dbo.table1 içeren bir görünüm geçersiz hale gelir. Bu sorunu çözmek için, görünümlerde üç parçalı isimler kullanmaktan kaçınabilir veya görünümleri yeni veritabanı adına referans verecek şekilde güncelleyebilirsiniz.

Bir tablo yeniden adlandırılırken, görünümler yeni tablo adına referans vermek için güncellenmez. Veritabanı içinde veya dışında, eski tablo adına referans veren her görünüm geçersiz hale gelir. Bu sorunu çözmek için, her görünümü yeni tablo adına referans verecek şekilde güncelleyebilirsiniz.

Sütun yeniden adlandırıldığında, görünümler yeni sütun adına başvuracak şekilde güncelleştirilmez. Görünümler, bir görünüm değiştirme işlemi gerçekleştirilene kadar eski sütun adını göstermeye devam eder. Bazı durumlarda, görüntülemeler geçersiz hale gelebilir ve bir dropup yeniden oluşturulması gerekir.

Kilitleme

Bir tablonun adını değiştirmek, nesne üzerinde paylaşılan bir kilit DATABASE , nesne üzerinde ortak kilit SCHEMA ve masada özel bir kilit gerektirir.

Examples

A. Veritabanını yeniden adlandırma

Şunlar için geçerlidir: Sadece Analitik Platform Sistemi (PDW)

Bu örnek, kullanıcı tanımlı veritabanının adını AdWorks2 olarak değiştirir.

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

Bir tablo yeniden adlandırılırken, tabloya bağlı tüm nesneler ve özellikler yeni tablo adına referans olacak şekilde güncellenir. Örneğin, tablo tanımları, indeksler, kısıtlamalar ve izinler güncellenir. Görüşler güncellenmiyor.

B. Tabloyu yeniden adlandırma

Şunlar için geçerlidir: Azure Synapse Analytics, Analiz Platformu Sistemi (PDW)

Bu örnek, Müşteri tablosunun adını Customer1 olarak değiştirir.

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

RENAME OBJECT mydb.dbo.Customer TO Customer1;

Bir tablo yeniden adlandırılırken, tabloya bağlı tüm nesneler ve özellikler yeni tablo adına referans olacak şekilde güncellenir. Örneğin, tablo tanımları, indeksler, kısıtlamalar ve izinler güncellenir. Görüşler güncellenmiyor.

C. Bir tabloyu farklı bir şemaya taşıyın

Şunlar için geçerlidir: Azure Synapse Analytics, Analiz Platformu Sistemi (PDW)

Amacınız nesneyi farklı bir şemaya taşımaksa, ALTER SCHEMA. Örneğin, aşağıdaki ifade tablo öğesini ürün şemasından dbo şemasına taşır.

ALTER SCHEMA dbo TRANSFER OBJECT::product.item;

D. Bir tablonun adını değiştirmeden önce oturumları sonlandırın

Şunlar için geçerlidir: Azure Synapse Analytics, Analiz Platformu Sistemi (PDW)

Bir tablo kullanılırken yeniden adlandıramazsınız. Bir tablonun adını değiştirmek, masanın özel bir kilidi gerektirir. Tablo kullanılıyorsa, oturumu tablo kullanarak sonlandırmanız gerekebilir. Bir oturumu sonlandırmak için KILL komutunu kullanabilirsiniz. KILL (ÖLDÜRME) dikkatli kullanın çünkü bir oturum sona erdiğinde taahhüt edilmemiş işler geri alınır. Azure Synapse Analytics içindeki oturumlar 'SID' ile prefikslenir. KILL komutunu çağırırken 'SID' ve oturum numarasını eklemeniz gerekecek. Bu örnek, aktif veya boşta oturumların listesini gösterir ve ardından oturum 'SID1234' sonlandırır.

-- 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. Bir sütunu yeniden adlandır

Şunlar için geçerlidir: Analitik Platform Sistemi (PDW)

Bu örnek, Müşteri tablosunun FName sütununu FirstName olarak yeniden adlandırıyor.

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

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

Sonraki Adımlar

  • Last updated on