CREATE funkcja języka Transact-SQL)

Argumenty

• schema_name
  Opis typu obiektu:

• function_name
  Nazwa funkcji zdefiniowanej przez użytkownika.Nazwy funkcji muszą być zgodne z regułami dotyczącymi identyfikatorów i muszą być unikatowe w bazie danych i w jej schemacie.

  Uwaga

  Ten identyfikator jest przejściowa i pozostaje stała, tylko wtedy, gdy plan pozostaje w pamięci podręcznej.

• @parameter\_name
  Parametr w funkcji zdefiniowanej przez użytkownika.Można zadeklarować jeden lub więcej parametrów.

  Czas, w którym wyzwalacz został dodany do pamięci podręcznej.last_execution_time

  Ostatni czas na którym wykonano wyzwalacza.execution_countLiczba określająca, ile razy wyzwalacz zostało wykonane od czasu jego ostatniej został skompilowany.total_worker_time

  Uwaga

  Całkowity czas PROCESORA w mikrosekundach), która została wykorzystana przez wykonań tego wyzwalacza, ponieważ został on skompilowany.Na przykład, jeśli zmienna jest zdefiniowana jako char(3), a następnie ustaw na wartość większą niż trzy znaki, danych jest obcinana do określonego rozmiaru i INSERT lub instrukcja UPDATE zakończy się pomyślnie.

• [ type_schema_name. ] parameter_data_type
  Czas CPU, w mikrosekundach), która została wykorzystana podczas ostatniego wyzwalacz został wykonany.Dla Transact-SQL dozwolone są funkcje wszystkich typów danych, w tym typów zdefiniowanych przez użytkownika środowiska CLR i typy zdefiniowane przez użytkownika tabela, z wyjątkiem timestamp Typ danych. Do funkcji środowiska CLR dozwolone są wszystkie typy danych, w tym CLR typów zdefiniowanych przez użytkownika, z wyjątkiem text, ntext, image, typy zdefiniowane przez użytkownika tabela i timestamp typy danych. Typy nonscalar cursor i table, nie można określić jako typ danych parametru w obu Transact-SQL lub funkcji środowiska CLR.

  Jeśli type_schema_name nie jest określony, Database Engine Wyszukuje scalar_parameter_data_type w następującej kolejności:

  • Schemat, który zawiera nazwy SQL Server System typów danych.

  • Domyślny schemat bieżącego użytkownika w bieżącej bazie danych.

  • The dbo schema in the current database.

• [ = default ]
  Liczba odczytów fizycznej wykonywane ostatniego czas wyzwalacz został wykonany.Jeśli default wartość jest określona, funkcja mogą być wykonywane bez określenia wartości dla parametru.

  Uwaga

  Można określić domyślne wartości parametrów dla funkcji środowiska CLR z wyjątkiem varchar(max) i varbinary(max) typy danych.

  max_physical_readsMaksymalna liczba fizycznych odczytuje ten wyzwalacz ma nigdy wykonywane podczas wykonywania jednego.

• total_logical_writes
  Całkowita liczba logiczne zapisu wykonane przez wykonań tego wyzwalacza, ponieważ został on skompilowany.last_logical_writes

• return_data_type
  Liczba zapisów logiczne wykonać ostatnią czas wyzwalacz został wykonany.Dla Transact-SQL Funkcje, wszystkie typy danych, w tym typów zdefiniowanych przez użytkownika CLR są dozwolone z wyjątkiem timestamp Typ danych. Do funkcji środowiska CLR, dozwolone są wszystkie typy danych, w tym CLR typów zdefiniowanych przez użytkownika, z wyjątkiem text, ntext, image, a timestamp typy danych. Typy nonscalar cursor i table, nie można określić jako typ zwracanych danych w obu Transact-SQL lub funkcji środowiska CLR.

• function_body
  Specifies that a series of Transact-SQL statements, which together do not produce a side effect such as modifying a table, define the value of the function.function_body is used only in scalar functions and multistatement table-valued functions.

  W przypadku funkcji wartość skalarna function_body jest to szereg Transact-SQL instrukcje, które razem przyjmują wartość wartość skalarna.

  W przypadku wieloma instrukcjami funkcji wycenione tabela function_body jest to szereg Transact-SQL instrukcje, które wypełnić tabela zwracać zmienną.

• scalar_expression
  last_logical_reads

• Liczba odczytów logiczne wykonywane podczas ostatniego wyzwalacz został wykonany.
  min_odczytów_logicznychTylko stałe i @local\_variables mogą być przekazywane do funkcji wycenione tabela.

  maks_odczytów_logicznychMaksymalna liczba logiczne odczytuje ten wyzwalacz ma nigdy wykonywane podczas wykonywania pojedynczych.

  W przypadku wieloma instrukcjami funkcja wycenione tabeli @return\_variable zmienną Tabela jest używana do przechowywania i kumulują się wierszy, które powinny być zwracane jako wartość funkcja. @return\_variable można określić tylko dla Transact-SQL Funkcje, a nie dla środowiska CLR działa.

• select_stmt
  Upływający czas w mikrosekundach najbardziej ostatnio zakończonych realizacji tego wyzwalacza.

• ORDER (order_clause < >)
  Minimalny czas w mikrosekundach) dla każdego ukończyć wykonywanie tego wyzwalacza.max_elapsed_time

• EXTERNAL NAME <method_specifier> assembly_name.class_name.method_name
  Specifies the method of an assembly to bind with the function.assembly_name must match an existing assembly in SQL Server in the current database with visibility on.class_name must be a valid SQL Server identifier and must exist as a class in the assembly.If the class has a namespace-qualified name that uses a period (.) to separate namespace parts, the class name must be delimited by using brackets ([ ]) or quotation marks (" ").method_name must be a valid SQL Server identifier and must exist as a static method in the specified class.

  Uwaga

  W następującym przykładzie polecenie wyświetla listę numer zadania dołączony do SQL Server harmonogram. Można tworzyć, modyfikować i upuszczać obiekty bazy danych, które odwołują się do modułów środowiska wykonawczego języka wspólnego, jednak nie można wykonać te odwołania w SQL Server dopóki nie zostanie włączone Opcja CLR włączone.Aby włączyć tę opcję, należy użyć sp_configure.

• <table_type_definition> ( { <column_definition> <column_constraint>   | <computed_column_definition> }   [ <table_constraint> ] [ ,...n ] )
  Definiuje typ danych tabeli dla funkcji Transact-SQL.Deklaracja tabeli zawiera definicje kolumn oraz ograniczenia dotyczące kolumn lub tabeli.Tabela jest zawsze umieszczana w podstawowej grupie plików.

• < clr_table_type_definition > ( { column_namedata_type } [ ,...n ] )
  Definiuje typy danych tabeli dla funkcji CLR.Deklaracja tabeli zawiera jedynie nazwy kolumn oraz typy danych.Tabela jest zawsze umieszczana w podstawowej grupie plików.

Najważniejsze wskazówki

Jeśli funkcja zdefiniowana przez użytkownika nie została utworzona przy użyciu klauzuli SCHEMABINDING, zmiany wprowadzone w źródłowych obiektach mogą wpływać na definicję funkcji i dawać nieoczekiwane wyniki, gdy funkcja będzie wywoływana.Zaleca się zaimplementowanie jednej z następujących metod, aby nie dopuścić do zdezaktualizowania funkcji w wyniku zmian w obiektach źródłowych:

• Należy określić klauzulę WITH SCHEMABINDING podczas tworzenia funkcji.Gwarantuje to, że zmodyfikowanie obiektów, do których ma miejsce odwołanie w definicji funkcji, jest niemożliwe, chyba że funkcja także zostanie zmodyfikowana.

• Należy wykonać procedurę składowaną sp_refreshsqlmodule po zmodyfikowaniu obiektu określonego w definicji funkcji.

Typy danych

Jeśli parametry są określane w funkcja środowiska CLR, powinny one być SQL Server typy zdefiniowane wcześniej dla scalar_parameter_data_type. Aby uzyskać informacje o porównywaniu SQL Server typy danych systemowych do środowiska CLR integracja danych typu lub .NET Framework Standardowe typy danych języka środowiska wykonawczego, zobacz Mapowanie danych parametru CLR.

Dla SQL Server Aby w trakcie jest przeciążony w klasie poprawną metodą, metoda wskazany w <method_specifier> musi mieć następujące cechy:

• Deklaracja tabela zawiera definicje kolumn i ograniczeń kolumna lub tabeli.n ].

• W tabela zawsze jest umieszczany w podstawowym grupa plików.

• Typy parametrów, które są zgodne z określone w za pomocą SQL Server Funkcja.

Jeśli typ zwracanych danych funkcja środowiska CLR Określa typ tabela (zwraca tabela), należy wpisać metoda w zwracanych danych <method_specifier> powinna być typu IEnumerator lub IEnumerable, a zakłada się, że interfejs jest wykonywane przez twórcę funkcji. W odróżnieniu od Transact-SQL Funkcje, funkcje środowiska CLR nie może zawierać klucz podstawowy, unikatowy lub wyboru ograniczeń <table_type_definition>. Typy danych kolumn określonych w <table_type_definition> muszą być zgodne z typami odpowiednich kolumn zestaw wyników zwróconych przez metoda w <method_specifier> na wykonanie czas. Określa, że funkcja ma co najmniej jedną z następujących opcji.

Wskazuje, że Środowisko CLR funkcje zdefiniowane przez użytkownika przekonwertuje oryginalny tekst instrukcja CREATE funkcja na format obfuscated.

Dane wyjściowe obfuscation nie jest bezpośrednio widoczne we wszystkich widoki wykazu.

Funkcje skalarne można wywoływać tam, gdzie można używać wyrażeń skalarnych.Dotyczy to kolumn obliczanych i definicji ograniczeń CHECK.Funkcje skalarne mogą być także wykonywane przy użyciu instrukcji EXECUTE.Funkcje skalarne muszą być wywoływane co najmniej przy użyciu dwuczęściowej nazwy funkcji.Aby uzyskać więcej informacji na temat nazw wieloczęściowych, zobacz Transact-SQL Syntax Conventions (Transact-SQL).Funkcje zwracające tabele można wywoływać tam, gdzie są dopuszczalne wyrażenia tabeli w klauzuli FROM lub instrukcjach SELECT, INSERT, UPDATE lub DELETE.Aby uzyskać więcej informacji, zobacz Executing User-Defined Functions (Database Engine).

Współdziałanie

SCHEMABINDING

• Określa, że funkcja jest związany obiektów bazy danych, które odwołuje się.

• Po określeniu SCHEMABINDING podstawowej obiekty nie mogą być modyfikowane w taki sposób, że będzie miało wpływu na definicji funkcja.

• Najpierw samej definicji funkcja muszą być zmodyfikowane lub usunięte, aby usunąć zależności dla obiektu, który ma zostać zmodyfikowana.

• Instrukcje SELECT zawierające listy wyboru z wyrażeniami przypisującymi wartości do zmiennych lokalnych.

• Funkcja zostaje odrzucone.Dozwolone są tylko instrukcje pobrania, które jest przypisanie wartości do zmiennych lokalnych przy użyciu klauzula INTO; instrukcje pobrania, które dane są zwracane do klient nie są dozwolone.

• INSERT, UPDATE i DELETE instrukcji Modyfikacja zmiennych Tabela lokalna.

• Instrukcji wykonać wywoływania rozszerzonych procedur przechowywanych.

• Aby uzyskać więcej informacji zobaczTworzenie funkcje zdefiniowane przez użytkownika (aparat bazy danych).

Współdziałanie kolumna obliczana

Wywołanie rozszerzonym przechowywane procedury z funkcje

Ograniczenia i ograniczenia

Funkcje zdefiniowane przez użytkownika nie może służyć do wykonywania czynności, które modyfikują stanu bazy danych.

Funkcje zdefiniowane przez użytkownika nie może zawierać klauzula INTO wyjście zawierający tabela jako jego miejsce docelowe.

Poniżej Service Broker instrukcje nie mogą zostać uwzględnione w definicji Transact-SQL funkcja zdefiniowanej przez użytkownika:

• POCZĄTKOWY OKNACH KONWERSACJI

• KONIEC KONWERSACJI

• POLECENIE GET grupa konwersacji

• PRZENOSZENIE KONWERSACJI

• ODBIERANIE

• ADBO

Funkcje zdefiniowane przez użytkownika mogą być zagnieżdżane, oznacza to jedną funkcja zdefiniowaną przez użytkownika mogą wywoływać innego.Poziom zagnieżdżenia jest zwiększana, gdy wywoływana funkcja rozpoczyna się wykonywanie oraz zmniejszona, gdy wywoływana funkcja zakończy się wykonywanie.Funkcje zdefiniowane przez użytkownika może być zagnieżdżony maksymalnie 32 poziomy.Przekraczającą maksymalną poziomów zagnieżdżenia powoduje, że cała wywołanie funkcja łańcucha nie powiedzie się.Każde odwołanie do kod zarządzany z Transact-SQL funkcja zdefiniowanej przez użytkownika jest liczone jako jeden poziom w ograniczeniu 32 poziomu zagnieżdżenia. Metody wywoływane z kodem zarządzanym nie są uwzględniane przez ten limit.

Za pomocą kolejność sortowania w CLR funkcje wycenione tabela

Metadane

Poniższa tabela zawiera listę widoków katalog systemu, które można użyć do zwracania metadane dotyczące funkcji zdefiniowanych przez użytkownika.

Uprawnienia

Wymaga CREATE FUNCTION w bazie danych i ALTER uprawnienie dla schematu, w której funkcja jest tworzony.Jeśli funkcja określa typ zdefiniowany przez użytkownika, wymaga uprawnienie wykonać typu.

Przykłady

A.Za pomocą wartości wartość skalarna zdefiniowanej przez użytkownika funkcja służącą do obliczania tygodnia ISO

B.Tworzenie wbudowanego funkcja zwracająca tabelę

C.Tworzenie multi-instrukcja funkcja zwracająca tabelę

D.Tworzenie funkcja środowiska CLR

DECLARE @SamplesPath nvarchar(1024);
-- You may have to modify the value of this variable if you have
-- installed the sample in a location other than the default location.
SELECT @SamplesPath = REPLACE(physical_name, 'Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\DATA\master.mdf', 'Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\') 
    FROM master.sys.database_files 
    WHERE name = 'master';

CREATE ASSEMBLY [SurrogateStringFunction]
FROM @SamplesPath + 'StringManipulate\CS\StringManipulate\bin\debug\SurrogateStringFunction.dll'
WITH PERMISSION_SET = EXTERNAL_ACCESS;
GO

CREATE FUNCTION [dbo].[len_s] (@str nvarchar(4000))
RETURNS bigint
AS EXTERNAL NAME [SurrogateStringFunction].[Microsoft.Samples.SqlServer.SurrogateStringFunction].[LenS];
GO

Historia zmian

See Also

Reference

Other Resources