CREATE CONTRACT (Transact-SQL)
Si applica a:
SQL Server Istanza gestita di SQL di Azure
Crea un nuovo contratto. Un contratto definisce i tipi di messaggio usati in una conversazione di Service Broker, nonché il lato della conversazione che può inviare messaggi di tale tipo. Ogni conversazione viene eseguita in base a un contratto. Il servizio di origine specifica il contratto per la conversazione all'avvio della conversazione stessa, mentre il servizio Target specifica i contratti accettati per le conversazioni.
Convenzioni di sintassi Transact-SQL
Sintassi
CREATE CONTRACT contract_name
[ AUTHORIZATION owner_name ]
( { { message_type_name | [ DEFAULT ] }
SENT BY { INITIATOR | TARGET | ANY }
} [ ,...n] )
[ ; ]
Nota
Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.
Argomenti
contract_name
Nome del contratto da creare. Il nuovo contratto viene creato nel database corrente e diventa di proprietà dell'identità specificata nella clausola AUTHORIZATION. Non è possibile specificare i nomi del server, del database e dello schema. contract_name può contenere fino a 128 caratteri.
Nota
Non creare un contratto che usa la parola chiave ANY per contract_name. Quando si specifica ANY per un nome del contratto in CREATE BROKER PRIORITY, la priorità viene considerata per tutti i contratti e non è limitata a un contratto il cui nome è ANY.
AUTHORIZATION owner_name
Imposta come proprietario del contratto l'utente o il ruolo del database specificato. Se l'utente corrente è dbo o sa, owner_name può essere il nome di qualsiasi utente o ruolo valido. In caso contrario, owner_name deve corrispondere al nome dell'utente corrente, al nome di un utente per il quale l'utente corrente dispone di autorizzazione IMPERSONATE oppure al nome di un ruolo a cui appartiene l'utente corrente. Se la clausola viene omessa, il contratto appartiene all'utente corrente.
message_type_name
Nome del tipo di messaggio da includere nel contratto.
SENT BY
Specifica l'endpoint che può inviare un messaggio del tipo indicato. I contratti documentano i messaggi che i servizi possono utilizzare per eseguire conversazioni specifiche. Ogni conversazione è caratterizzata da due endpoint, l'endpoint initiator (servizio che ha avviato la conversazione) e l'endpoint target (servizio che l'endpoint initiator sta contattando).
INITIATOR
Indica che solo l'endpoint initiator della conversazione può inviare messaggi del tipo specificato. Un servizio che avvia una conversazione viene definito initiator (iniziatore) della conversazione.
TARGET
Indica che solo l'endpoint target della conversazione può inviare messaggi del tipo specificato. Un servizio che accetta una conversazione avviata da un altro servizio viene definito target (destinazione) della conversazione.
QUALSIASI
Indica che i messaggi del tipo specificato possono essere inviati sia dal servizio initiator che dal servizio target.
[ DEFAULT ]
Indica che il contratto supporta messaggi del tipo predefinito. Per impostazione predefinita, tutti i database contengono un tipo di messaggio denominato DEFAULT. Questo tipo di messaggio utilizza la convalida di tipo NONE. Nel contesto di questa clausola DEFAULT non è una parola chiave ed è pertanto necessario delimitarlo come identificatore. In Microsoft SQL Server è inoltre disponibile un contratto DEFAULT che specifica il tipo di messaggio DEFAULT.
Osservazioni:
L'ordine dei tipi di messaggio nel contratto non è significativo. Dopo che il servizio di destinazione ha ricevuto il primo messaggio, Service Broker consente a ogni lato della conversazione di inviare qualsiasi messaggio consentito al lato specifico in qualunque momento. Se, ad esempio, il lato che ha avviato la conversazione può inviare messaggi di tipo //Adventure-Works.com/Expenses/SubmitExpense, Service Broker consente a tale lato di inviare un numero qualsiasi di messaggi SubmitExpense durante la conversazione.
In un contratto non è possibile modificare i tipi di messaggio e la direzione dei messaggi. Per modificare il parametro AUTHORIZATION per un contratto, utilizzare l'istruzione ALTER AUTHORIZATION.
Un contratto deve consentire al servizio initiator di inviare un messaggio. L'istruzione CREATE CONTRACT ha esito negativo se il contratto non include almeno un tipo di messaggio SENT BY ANY o SENT BY INITIATOR.
Indipendentemente dal contratto, un servizio può sempre ricevere i tipi di messaggio https://schemas.microsoft.com/SQL/ServiceBroker/DialogTimer, https://schemas.microsoft.com/SQL/ServiceBroker/Error e https://schemas.microsoft.com/SQL/ServiceBroker/EndDialog. Service Broker usa questi tipi di messaggio per i messaggi di sistema all'applicazione.
Un contratto non può essere un oggetto temporaneo. Sono consentiti i nomi di contratto che iniziano con #, ma in questo caso si tratta di oggetti permanenti.
Autorizzazioni
Per impostazione predefinita i membri del ruolo predefinito del database db_ddladmin o db_owner e del ruolo predefinito del server sysadmin possono creare contratti.
Per impostazione predefinita il proprietario del contratto, i membri del ruolo predefinito del database db_ddladmin o db_owner e i membri del ruolo predefinito del server sysadmin dispongono dell'autorizzazione REFERENCES per un contratto.
L'utente che esegue l'istruzione CREATE CONTRACT deve disporre dell'autorizzazione REFERENCES per tutti i tipi di messaggio specificati.
Esempi
R. Creazione di un contratto
Nell'esempio seguente viene creato un contratto per il rimborso spese in base a tre tipi di messaggio.
CREATE MESSAGE TYPE
[//Adventure-Works.com/Expenses/SubmitExpense]
VALIDATION = WELL_FORMED_XML ;
CREATE MESSAGE TYPE
[//Adventure-Works.com/Expenses/ExpenseApprovedOrDenied]
VALIDATION = WELL_FORMED_XML ;
CREATE MESSAGE TYPE
[//Adventure-Works.com/Expenses/ExpenseReimbursed]
VALIDATION= WELL_FORMED_XML ;
CREATE CONTRACT
[//Adventure-Works.com/Expenses/ExpenseSubmission]
( [//Adventure-Works.com/Expenses/SubmitExpense]
SENT BY INITIATOR,
[//Adventure-Works.com/Expenses/ExpenseApprovedOrDenied]
SENT BY TARGET,
[//Adventure-Works.com/Expenses/ExpenseReimbursed]
SENT BY TARGET
) ;
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per