FOR XML AUTO

Der AUTO-Modus generiert verschachtelte Elemente innerhalb des XML-Dokuments.

Wenn die ELEMENTS-Klausel weggelassen wurde, wird jede in der SELECT-Liste referenzierte Tabelle in der generierten XML-Datei als Element dargestellt. Die Reihenfolge der Verschachtelung basiert auf der Reihenfolge, in der die Spalten in der SELECT-Liste referenziert wurden. Für jede Spalte in der SELECT-Liste wird ein Attribut erstellt.

Wenn die ELEMENTS-Klausel vorhanden ist, wird jede in der SELECT-Liste referenzierte Tabelle und Spalte in der generierten XML-Datei als Element dargestellt. Die Reihenfolge der Verschachtelung basiert auf der Reihenfolge, in der die Spalten in der SELECT-Liste referenziert wurden. Für jede Spalte in der SELECT-Liste wird ein Element erstellt.

Syntax

FOR XML AUTO[, ELEMENTS ]

Parameter

ELEMENTS Fordert FOR XML AUTO auf, im Ergebnis ein XML-Element anstatt eines Attributs für jede Spalte zu generieren. Beispiel:

SELECT Employees.EmployeeID, Departments.DepartmentName FROM Employees JOIN Departments ON Employees.DepartmentID=Departments.DepartmentID ORDER BY EmployeeID FOR XML AUTO, ELEMENTS;

In diesem Fall wird jede Spalte in der Ergebnismenge als separates Element zurückgegeben und nicht als Attribut des <Employees>- oder <Departments>-Elements. Wenn NULL vorhanden ist, wird das Element im generierten XML-Dokument weggelassen.

<Employees>
   <EmployeeID>102</EmployeeID>
   <Departments>
      <DepartmentName>R &amp; D</DepartmentName>
   </Departments>
</Employees> 
<Employees>
   <EmployeeID>105</EmployeeID>
   <Departments>
      <DepartmentName>R &amp; D</DepartmentName>
   </Departments>
</Employees> 
<Employees>
   <EmployeeID>129</EmployeeID>
   <Departments>
   <DepartmentName>Sales</DepartmentName>
   </Departments>
</Employees>
...

Verwendung

Wenn Sie eine Abfrage ausführen, die FOR XML AUTO sowie Daten in BINARY-, LONG BINARY-, IMAGE- und VARBINARY-Spalten verwendet, werden Spalten automatisch im base64-kodiertem Format zurückgegeben. Standardmäßig wird NULL im Ergebnis weggelassen. Sie können NULL als leere Attribute zurückgeben, indem Sie die Option "for_xml_null_treatment" auf EMPTY setzen.

Sofern nicht anders angegeben, gibt der Datenbankserver die Zeilen einer Tabelle in einer beliebigen Reihenfolge zurück. Wenn Sie wollen, dass die Ergebnisse in einer bestimmten Reihenfolge angezeigt werden oder dass ein übergeordnetes Objekt (Parent) mehrere untergeordnete Objekte (Child) hat, nehmen Sie eine ORDER BY-Klausel in die Abfrage auf, damit alle Child-Objekte benachbart sind. Wenn Sie keine ORDER BY-Klausel angeben, hängt die Verschachtelung der Ergebnisse vom Plan ab, der vom Optimierer ausgesucht wurde, was möglicherweise nicht zu der von Ihnen gewünschten Verschachtelung führt.

FOR XML AUTO gibt kein wohlgeformtes XML-Dokument zurück, weil das Dokument keinen einzelnen Stammknoten hat. Wenn ein <root>-Element erforderlich ist, können Sie eines einfügen, indem Sie die XMLELEMENT-Funktion verwenden. Beispiel:

SELECT XMLELEMENT( NAME root,
                   (SELECT EmployeeID AS id, GivenName AS name
                   FROM Employees FOR XML AUTO ) );

Sie können die Attribut- oder Elementnamen ändern, die im XML-Dokument verwendet werden, indem Sie Aliasnamen angeben. Die folgende Abfrage benennt das ID-Attribut in "product_ID" um:

SELECT ID AS product_ID
FROM Products
WHERE Color='Black'
FOR XML AUTO;

Der folgende XML-Inhalt wird generiert:

<Products product_ID="302"/>
<Products product_ID="400"/>
<Products product_ID="501"/>
<Products product_ID="700"/>

Sie können auch die Tabelle mit einem Alias umbenennen. Die folgende Abfrage ändert den Namen der Tabelle zu "product_info":

SELECT ID AS product_ID
FROM Products AS product_info
WHERE Color='Black'
FOR XML AUTO;

Der folgende XML-Inhalt wird generiert:

<product_info product_ID="302"/>
<product_info product_ID="400"/>
<product_info product_ID="501"/>
<product_info product_ID="700"/>

Beispiel

Die folgende Abfrage generiert XML, das sowohl das <employee>- als auch das <department>-Element enthält, wobei das <employee>-Element (die Tabelle, die als erste in der SELECT-Liste vorkommt) das übergeordnete Objekt des <department>-Elements darstellt.

SELECT EmployeeID, DepartmentName
FROM Employees AS employee 
JOIN Departments AS department
   ON employee.DepartmentID=department.DepartmentID
ORDER BY EmployeeID
FOR XML AUTO;

Das folgende XML wird durch die oben stehende Abfrage generiert:

<employee EmployeeID="102">
   <department DepartmentName="R &amp; D"/>
</employee>
<employee EmployeeID="105">
   <department DepartmentName="R &amp; D"/>
</employee>
<employee EmployeeID="129">
   <department DepartmentName="Sales;"/>
</employee>
<employee EmployeeID="148">
   <department DepartmentName="Finance;"/>
</employee>
...

Ändern Sie die Reihenfolge der Spalten in der SELECT-Liste wie folgt:

SELECT DepartmentName, EmployeeID
FROM Employees AS employee JOIN Departments AS department
   ON employee.DepartmentID=department.DepartmentID
ORDER BY 1, 2
FOR XML AUTO;

Das Ergebnis wird folgendermaßen verschachtelt:

<department DepartmentName="Finance">
   <employee EmployeeID="148"/>
   <employee EmployeeID="390"/>
   <employee EmployeeID="586"/>
   ...
</department> 
<department DepartmentName="Marketing">
   <employee EmployeeID="184"/>
   <employee EmployeeID="207"/>
   <employee EmployeeID="318"/>
   ...
</department>
...

Wieder enthält das für diese Abfrage generierte XML sowohl das <employee> als auch das <department>-Element, aber in diesem Fall ist das <department>-Element das übergeordnete Objekt des <employee>-Elements.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.