Sdílet prostřednictvím

sp_updateextendedproperty (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Aktualizuje hodnotu existující rozšířené nemovitosti.

Transact-SQL konvence syntaxe

Syntaxe

sp_updateextendedproperty
    [ @name = ] N'name'
    [ , [ @value = ] value ]
    [ , [ @level0type = ] 'level0type' ]
    [ , [ @level0name = ] N'level0name' ]
    [ , [ @level1type = ] 'level1type' ]
    [ , [ @level1name = ] N'level1name' ]
    [ , [ @level2type = ] 'level2type' ]
    [ , [ @level2name = ] N'level2name' ]
[ ; ]

Arguments

[ @name = ] N'jméno'

Název nemovitosti, která bude aktualizována. @name je sysname, bez výchozího nastavení.

[ @value = ] hodnota

Hodnota spojená s nemovitostí. @value je sql_variants výchozím NULL. Velikost hodnoty nesmí být větší než 7 500 bajtů.

[ @level0type = ] 'level0type'

Uživatelsky nebo uživatelem definovaný typ. @level0type je varchar(128), s výchozím hodnotou NULL. Platné vstupy jsou:

  • ASSEMBLY
  • CONTRACT
  • EVENT NOTIFICATION
  • FILEGROUP
  • MESSAGE TYPE
  • PARTITION FUNCTION
  • PARTITION SCHEME
  • PLAN GUIDE
  • REMOTE SERVICE BINDING
  • ROUTE
  • SCHEMA
  • SERVICE
  • USER
  • TRIGGER
  • TYPE
  • NULL

Důležité

USER a TYPEjako úrovně 0 typy budou odstraněny v budoucí verzi SQL Serveru. Vyhněte se používání těchto funkcí v nové vývojové práci a naplánujte úpravu aplikací, které tyto funkce aktuálně používají. Použijte SCHEMA jako typ úrovně 0 místo .USER Pro TYPE, použijte SCHEMA jako typ úrovně 0 a TYPE jako typ úrovně 1 .

[ @level0name = ] N'level0name'

Název specifikovaného typu objektu úrovně 0. @level0name je sysname s výchozím nastavením NULL.

[ @level1type = ] 'level1type'

Typ objektu úrovně 1. @level1type je varchar(128), s výchozím hodnotou NULL. Platné vstupy jsou:

  • ASSEMBLY
  • CONTRACT
  • EVENT NOTIFICATION
  • FILEGROUP
  • MESSAGE TYPE
  • PARTITION FUNCTION
  • PARTITION SCHEME
  • PLAN GUIDE
  • REMOTE SERVICE BINDING
  • ROUTE
  • SCHEMA
  • SERVICE
  • USER
  • TRIGGER
  • TYPE
  • NULL

[ @level1name = ] N'level1name'

Název specifikovaného typu objektu úrovně 1. @level1name je sysname s výchozím nastavením NULL.

[ @level2type = ] 'level2type'

Typ objektu úrovně 2. @level2type je varchar(128), s výchozím hodnotou NULL. Platné vstupy jsou:

  • COLUMN
  • CONSTRAINT
  • EVENT NOTIFICATION
  • INDEX
  • PARAMETER
  • TRIGGER
  • NULL

[ @level2name = ] N'level2name'

Název specifikovaného typu objektu úrovně 2. @level2name je sysname s výchozím nastavením NULL.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

Když specifikujete rozšířené vlastnosti, objekty v databázi SQL Server jsou klasifikovány do tří úrovní (0, 1 a 2). Úroveň 0 je nejvyšší úroveň a je definována jako objekty obsažené v rozsahu databáze. Objekty úrovně 1 jsou obsaženy ve schématu nebo uživatelském rozsahu a objekty úrovně 2 jsou obsaženy v objektech úrovně 1. Rozšířené vlastnosti lze definovat pro objekty na kterékoliv z těchto úrovní. Odkazy na objekt v jedné úrovni musí být kvalifikovány názvy objektů vyšší úrovně, které je vlastní nebo obsahují.

Pro platné @name a @value, pokud jsou všechny typy a názvy objektů , NULLvlastnost, která se aktualizuje, patří do aktuální databáze.

Povolení

Členové pevných databázových rolí db_owner a db_ddladmin mohou aktualizovat rozšířené vlastnosti jakéhokoli objektu s následující výjimkou: db_ddladmin nemůže přidávat vlastnosti přímo do databáze, uživatelů nebo rolí.

Uživatelé mohou aktualizovat rozšířené vlastnosti na objekty, které vlastní, nebo na které mají oprávnění ALTER či CONTROL.

Examples

A. Aktualizovat rozšířenou vlastnost ve sloupci

Následující příklad aktualizuje hodnotu vlastnosti Caption ve sloupci ID v tabulce T1.

USE AdventureWorks2022;
GO

CREATE TABLE T1 (id INT, name CHAR (20));
GO

EXECUTE sp_addextendedproperty
    @name = N'Caption',
    @value = N'Employee ID',
    @level0type = 'SCHEMA',
    @level0name = N'dbo',
    @level1type = 'TABLE',
    @level1name = N'T1',
    @level2type = 'COLUMN',
    @level2name = N'id';
GO

--Update the extended property.
EXECUTE sp_updateextendedproperty
    @name = N'Caption',
    @value = 'Employee ID must be unique.',
    @level0type = 'SCHEMA',
    @level0name = N'dbo',
    @level1type = 'TABLE',
    @level1name = N'T1',
    @level2type = 'COLUMN',
    @level2name = N'id';
GO

B. Aktualizace rozšířené vlastnosti v databázi

Následující příklad nejprve vytvoří rozšířenou vlastnost ve vzorkové databázi AdventureWorks2025 a poté aktualizuje hodnotu této vlastnosti.

USE AdventureWorks2022;
GO

EXECUTE sp_addextendedproperty
    @name = N'NewCaption',
    @value = 'AdventureWorks Sample OLTP Database';
GO

USE AdventureWorks2022;
GO

EXECUTE sp_updateextendedproperty
    @name = N'NewCaption',
    @value = 'AdventureWorks Sample Database';
GO

Související obsah

  • Last updated on