sp_rename (Transact-SQL) (Suomi)

• 14.10.2020
• 6 minuuttia aikaa lukea
• • m
  • c
  • M
  • m
  • r
  • +5

Koskee: SQL Server (kaikki tuetut versiot) Azure SQL -tietokanta Azure Synapse Analytics

Muuttaa käyttäjän luoman objektin nimen nykyisessä tietokannassa . Tämä objekti voi olla taulukko, hakemisto, sarake, aliaksen tietotyyppi tai Microsoft .NET Frameworkin yleisen kielen ajonaikainen (CLR) käyttäjän määrittelemä tyyppi.

Transact-SQL-syntaksin yleissopimukset

Syntaksi

Argumentit

”object_name”
on käyttäjäobjektin tai tietotyypin nykyinen hyväksytty tai kelvoton nimi. Jos nimettävä objekti on taulukon sarake, objektinimen on oltava muodossa table.column tai schema.table.column. Jos nimettävä objekti on hakemisto, objektinimen on oltava muodossa table.index tai schema.table.index. Jos nimettävä objekti on rajoitus, objektin_nimen on oltava muodossa schema.constraint.

Lainausmerkit ovat välttämättömiä vain, jos määritetty pätevä objekti. Jos annetaan täydellinen nimi, mukaan lukien tietokannan nimi, tietokannan nimen on oltava nykyisen tietokannan nimi. object_name on nvarchar (776), ilman oletusarvoa.

”new_name”
Onko määritetyn objektin uusi nimi. new_name on oltava yksiosainen nimi ja sen on noudatettava tunnisteiden sääntöjä. uusi nimi on sysname, ilman oletusta.

Arvo	Kuvaus
COLUMN	Nimettävä sarake.
TIETOKANTA	Käyttäjän määrittelemä tietokanta. Tämä objektityyppi vaaditaan tietokannan uudelleennimeämiselle.
INDEX	Käyttäjän määrittelemä hakemisto. Hakemiston uudelleennimeäminen tilastoineen nimetään myös tilastot automaattisesti uudelleen.
OBJECT	Sys.objects-tiedostossa seurattava tyyppi. Esimerkiksi OBJECTia voidaan käyttää nimittämään uudelleen objektit, mukaan lukien rajoitukset (CHECK, FOREIGN KEY, PRIMARY / UNIQUE KEY), käyttäjätaulukot ja säännöt.
STATISTICS	Koskee seuraavia: SQL Server 2012 (11.x) ja sitä uudempia versioita sekä Azure SQL -tietokantaa. Käyttäjän nimenomaisesti luomat tai implisiittisesti indeksillä luodut tilastot. Hakemiston tilastojen uudelleennimeäminen nimeää myös indeksin automaattisesti.
USERDATATYPE	CLR-käyttäjän määrittelemät tyypit, jotka on lisätty suorittamalla CREATE TYPE tai sp_addtype.

”COLUMN” Koskee seuraavia: Azure Synapse Analytics
sp_rename (esikatselu) ) Azure Synapse Analyticsille COLUMN on pakollinen parametri, joka määrittää, että nimettävä objektityyppi on sarake. Se on varchar (13), jolla ei ole oletusarvoa, ja se on aina sisällytettävä sp_rename (esikatselu) -käskyyn. Sarake voidaan nimetä uudelleen vain, jos se on ei-jakelu -sarake.

Palautuskoodiarvot

0 (onnistuminen) tai ei-nollanumero (epäonnistuminen)

Huomautuksia

Koskee SQL Serveriä (kaikki tuetut versiot) ja Azure SQL Database
sp_rename nimeää liittyvän hakemiston automaattisesti aina, kun PRIMARY KEY- tai UNIQUE -rajoitukset nimetään uudelleen. Jos nimetty hakemisto on sidottu PRIMARY KEY -rajoitukseen, sp_rename nimeää myös PRIMARY KEY -rajoituksen automaattisesti.

Koskee SQL Serveriä (kaikki tuetut versiot) ja Azure SQL Database
sp_rename voidaan käyttää nimetä uudelleen ensisijaiset ja toissijaiset XML-hakemistot.

Koskee SQL Serveriä (kaikki tuetut versiot) ja Azure SQL Database
Tallennetun menettelyn, toiminnon, näkymän tai liipaisimen uudelleennimeäminen ei muuta vastaavan nimen nimeä. objekti joko sys.sql_modules-luettelonäkymän määrittelysarakkeessa tai saatu sisäisellä OBJECT_DEFINITION-toiminnolla. Siksi suosittelemme, että sp_rename ei käytetä näiden objektityyppien uudelleennimeämiseen. Sen sijaan pudota ja luo objekti uudella nimellä.

Koskee SQL Serveriä (kaikki tuetut versiot), Azure SQL -tietokantaa ja Azure Synapse Analyticsia
Nimeä objekti, kuten taulukko tai -sarakkeessa ei nimetä uudelleen viitteitä kyseiseen objektiin.Sinun on muokattava kaikki objektit, jotka viittaavat nimettyyn objektiin manuaalisesti. Jos esimerkiksi nimeät taulukon sarakkeen uudelleen ja kyseiseen sarakkeeseen viitataan liipaisimessa, sinun on muokattava liipaisinta vastaamaan uuden sarakkeen nimeä. Käytä objektin sys.sql_expression_dependencies luetteloita riippuvuudet objektista ennen sen uudelleennimeämistä.

Koskee SQL Serveriä (kaikki tuetut versiot), Azure SQL Database ja Azure Synapse Analytics
Voit muuttaa objektin nimen tai tietotyyppi vain nykyisessä tietokannassa. Useimpien järjestelmätietotyyppien ja järjestelmäobjektien nimiä ei voi muuttaa.

Käyttöoikeudet

Objektien, sarakkeiden ja hakemistojen uudelleennimeäminen edellyttää objektin ALTER-lupaa. Käyttäjätyyppien uudelleennimeäminen edellyttää tyypin CONTROL-lupaa. Tietokannan uudelleennimeäminen edellyttää jäsenyyttä kiinteän palvelimen sysadmin- tai dbcreator-rooleissa.

Esimerkkejä

A. Taulukon uudelleennimeäminen

Seuraava esimerkki nimittää SalesTerritory -taulukon uudeksi nimeksi SalesTerr Sales skeema.

B. Sarakkeen uudelleennimeäminen

Seuraava esimerkki nimeää TerritoryID -sarakkeen SalesTerritory -taulukon TerrID.

C. Hakemiston uudelleennimeäminen

Seuraava esimerkki nimeää IX_ProductVendor_VendorID -hakemiston uudeksi nimeksi IX_VendorID.

D . Aliaksen tietotyypin uudelleennimeäminen

Seuraava esimerkki nimittää Phone aliaksen tietotyypin uudeksi nimeksi Telephone.

E. Rajoitusten nimeäminen uudelleen

Seuraavissa esimerkeissä nimetään uudelleen PRIMARY KEY -rajoitin, CHECK-rajoitus ja FOREIGN KEY -rajoitus. Rajoitusta uudelleennimettäessä on määritettävä skeema, johon rajoitus kuuluu.

F. Tilastojen uudelleennimeäminen

Seuraava esimerkki luo tilasto-objektin nimeltä contactMail1 ja nimeä sitten tilastotiedoksi NewContact käyttämällä sp_rename. Kun nimetään uudelleen tilastoja, objekti on määritettävä muodossa schema.table.statistics_name.

Esimerkkejä: Azure Synapse Analytics

G. Sarakkeen uudelleennimeäminen

Seuraava esimerkki nimeää c1 -sarakkeen table1 -taulukon nimeksi col1.

Katso myös