Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:SQL Server
Azure SQL Database
Azure SQL Managed Instance
Baza danych SQL w usłudze Microsoft Fabric
Obsługa typu danych xml (Transact-SQL) w programie SQL Server umożliwia opcjonalne zażądanie, aby wynik zapytania FOR XML został zwrócony jako xml, przez określenie dyrektywy TYPE. Dzięki temu można przetworzyć wynik zapytania FOR XML na serwerze. Można na przykład określić dla niego zapytanie XQuery, przypisać wynik do zmiennej typu xml , lub zapisać zagnieżdżone zapytania FOR XML .
Notatka
SQL Server zwraca klientowi dane wystąpienia typu danych xml w wyniku działania różnych mechanizmów po stronie serwera, takich jak zapytania FOR XML używające dyrektywy TYPE, a także wtedy, gdy typ danych xml służy do zwracania wartości wystąpień XML z kolumn tabel SQL oraz parametrów wyjściowych. W kodzie aplikacji klienckiej dostawca ADO.NET żąda informacji o typie danych xml do wysłania w kodowaniu binarnym od serwera. Jeśli jednak używasz formatu FOR XML bez TYPE dyrektywy, dane XML są zwracane jako typ ciągu. W każdym razie dostawca klienta będzie zawsze mógł obsłużyć jedną z form XML. Należy pamiętać, że klauzula FOR XML najwyższego poziomu bez dyrektywy TYPE nie może być używana z kursorami.
Przykłady
Poniższe przykłady ilustrują użycie dyrektywy TYPE w zapytaniach FOR XML.
Pobieranie wyników zapytania FOR XML jako typu danych XML
Poniższe zapytanie pobiera informacje kontaktowe klienta z tabeli Contacts. Ponieważ dyrektywa TYPE jest określona w FOR XML, wynik jest zwracany jako xml typu.
Notatka
W Azure SQL Database oraz w bazie danych SQL w Microsoft Fabric instrukcja USE nie jest dostępna. Zamiast tego połącz się bezpośrednio z docelową bazą danych i uruchom resztę próbki kodu.
USE AdventureWorks2022;
Go
SELECT BusinessEntityID, FirstName, LastName
FROM Person.Person
ORDER BY BusinessEntityID
FOR XML AUTO, TYPE;
Jest to wynik częściowy:
<Person.Person BusinessEntityID="1" FirstName="Ken" LastName="Sánchez"/>
<Person.Person BusinessEntityID="2" FirstName="Terri" LastName="Duffy"/>
...
Przypisywanie wyników zapytania FOR XML do zmiennej typu XML
W poniższym przykładzie wynik FOR XML jest przypisywany do zmiennej typu xml @x. Zapytanie pobiera informacje kontaktowe, takie jak BusinessEntityID, FirstName, LastNamei dodatkowe numery telefonów, z kolumny AdditionalContactInfo tabeli XML TYPE. Ponieważ klauzula FOR XML określa dyrektywę TYPE, kod XML jest zwracany jako typ xml i jest przypisywany do zmiennej.
USE AdventureWorks2022;
GO
DECLARE @x xml;
SET @x = (
SELECT BusinessEntityID,
FirstName,
LastName,
AdditionalContactInfo.query('
declare namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
//act:telephoneNumber/act:number') as MorePhoneNumbers
FROM Person.Person
FOR XML AUTO, TYPE);
SELECT @x;
GO
Wykonywanie zapytań dotyczących wyników zapytania FOR XML
Zapytania FOR XML zwracają kod XML. Dlatego można zastosować metody typu xml, takie jak query() i value(), do wyniku XML zwróconego przez zapytania FOR XML.
W poniższym zapytaniu metoda query() typu danych xml jest używana do zapytań o wynik zapytania FOR XML. Aby uzyskać więcej informacji, zobacz query() Method (xml Data Type).
USE AdventureWorks2022;
GO
SELECT (SELECT BusinessEntityID, FirstName, LastName, AdditionalContactInfo.query('
DECLARE namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
DECLARE namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
//act:telephoneNumber/act:number
') AS PhoneNumbers
FROM Person.Person
FOR XML AUTO, TYPE).query('/Person.Person[1]');
Zapytanie wewnętrzne SELECT ... FOR XML zwraca wynik typu xml xml, do którego zewnętrzny SELECT stosuje metodę query() do typu xml. Zwróć uwagę na określoną dyrektywę TYPE.
Jest to wynik:
<Person.Person BusinessEntityID="1" FirstName="Ken" LastName="Sánchez">
<PhoneNumbers>
<act:number xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">111-111-1111</act:number>
<act:number xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">112-111-1111</act:number>
</PhoneNumbers>
</Person.Person>
W poniższym zapytaniu metoda value() typu danych xml jest używana do pobierania wartości z wyniku XML zwróconego przez zapytanie SELECT...FOR XML. Aby uzyskać więcej informacji, zobacz value() Method (xml Data Type).
USE AdventureWorks2022;
GO
DECLARE @FirstPhoneFromAdditionalContactInfo varchar(40);
SELECT @FirstPhoneFromAdditionalContactInfo =
( SELECT BusinessEntityID, FirstName, LastName, AdditionalContactInfo.query('
declare namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
//act:telephoneNumber/act:number
') AS PhoneNumbers
FROM Person.Person Contact
FOR XML AUTO, TYPE).value('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
/Contact[@BusinessEntityID="1"][1]/PhoneNumbers[1]/act:number[1]', 'varchar(40)'
);
SELECT @FirstPhoneFromAdditionalContactInfo;
Wyrażenie ścieżki XQuery w metodzie value() pobiera pierwszy numer telefonu klienta kontaktowego, dla którego BusinessEntityID to 1.
Notatka
TYPE Jeśli dyrektywa nie jest określona, wynik zapytania FOR XML jest zwracany jako typ nvarchar(max).
Używanie wyników zapytania FOR XML w kodzie INSERT, UPDATEi DELETE (Transact-SQL DML)
W poniższym przykładzie pokazano, jak zapytania FOR XML mogą być używane w instrukcjach języka DML (Data Manipulation Language). W tym przykładzie FOR XML zwraca wystąpienie typu xml. Instrukcja INSERT wstawia ten kod XML do tabeli.
CREATE TABLE T1(intCol int, XmlCol xml);
GO
INSERT INTO T1
VALUES(1, '<Root><ProductDescription ProductModelID="1" /></Root>');
GO
CREATE TABLE T2(XmlCol xml)
GO
INSERT INTO T2(XmlCol)
SELECT (SELECT XmlCol.query('/Root')
FROM T1
FOR XML AUTO,TYPE);
GO