Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:SQL Server
Azure SQL Database
Ha XPath-lekérdezést hajt végre egy XSD-sémán, az eredményként kapott XML-dokumentum a sémában megadott elemeket és attribútumokat tartalmazza. Az sql:hide megjegyzés használatával megadhatja, hogy egyes elemek és attribútumok rejtve legyenek a sémában. Ez akkor hasznos, ha a lekérdezés kiválasztási feltételei bizonyos elemeket vagy attribútumokat igényelnek a sémában, de nem szeretné, hogy azokat a létrehozott XML-dokumentumban adja vissza.
A sql:hide jegyzet logikai értéket vesz fel (0=false, 1=true). Az elfogadható értékek a következők: 0, 1, true és false.
Példák
Ha az alábbi példákat használva szeretne munkamintákat létrehozni, meg kell felelnie bizonyos követelményeknek. További információ: SQLXML-példák futtatásának követelményei.
Egy. Sql:hide megadása attribútumon
A példában szereplő XSD-séma egy <Person.Contact> elemet tartalmaz ContactID, FirstNameés LastName attribútumokkal.
A <Person.Contact> elem összetett típusú, ezért az azonos nevű táblára képez le (alapértelmezett leképezés). A <Person.Contact> elem összes attribútuma egyszerű típusú, és az AdventureWorks adatbázis Person.Contactable elemében szereplő azonos nevű oszlopokra van megfeleltetve. A sémában az sql:hide megjegyzés a ContactID attribútumban van megadva. Ha XPath-lekérdezést ad meg ehhez a sémához, a ContactID nem jelenik meg az XML-dokumentumban.
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:element name="Person.Contact" >
<xsd:complexType>
<xsd:attribute name="ContactID" sql:hide="true" />
<xsd:attribute name="FirstName" type="xsd:string" />
<xsd:attribute name="LastName" type="xsd:string" />
</xsd:complexType>
</xsd:element>
</xsd:schema>
Minta XPath-lekérdezés tesztelése a sémán
Másolja ki a fenti sémakódot, és illessze be egy szövegfájlba. Mentse a fájlt Hide.xml.
Másolja ki a következő sablont, és illessze be egy szövegfájlba. Mentse a fájlt HideT.xml ugyanabban a könyvtárban, amelyben Hide.xmlmentette.
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> <sql:xpath-query mapping-schema="Hide.xml"> /Person.Contact[@ContactID="1"] </sql:xpath-query> </ROOT>A leképezési sémához (Hide.xml) megadott könyvtár elérési útja ahhoz a könyvtárhoz képest van, amelyben a sablont mentette. Egy abszolút elérési út is megadható, például:
mapping-schema="C:\MyDir\Hide.xml"Hozza létre és használja az SQLXML 4.0 tesztszkriptet (Sqlxml4test.vbs) a sablon végrehajtásához.
További információ: SQLXML 4.0-lekérdezések végrehajtása az ADO használatával.
Az eredményhalmaz a következő:
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<Person.Contact FirstName="Gustavo" LastName="Achong" />
</ROOT>
Ha sql:hide van megadva egy elemen, az elem és attribútumai vagy gyermekelemei nem jelennek meg a létrehozott XML-dokumentumban. Íme egy másik XSD-séma, amelyben sql:hide van megadva a <OD> elemen:
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:dt="urn:schemas-microsoft-com:datatypes"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
<xsd:documentation>
Sales.Customer-Sales.SalesOrderHeader-Sales.SalesOrderDetail Schema
Copyright 2004 Microsoft. All rights reserved.
</xsd:documentation>
<xsd:appinfo>
<sql:relationship name="CustomerOrder"
parent="Sales.Customer"
parent-key="CustomerID"
child-key="CustomerID"
child="Sales.SalesOrderHeader" />
<sql:relationship name="OrderOrderDetails"
parent="Sales.SalesOrderHeader"
parent-key="SalesOrderID"
child-key="SalesOrderID"
child="Sales.SalesOrderDetail"/>
</xsd:appinfo>
</xsd:annotation>
<xsd:element name="Customers" sql:relation="Sales.Customer">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"
maxOccurs="unbounded"
sql:relationship="CustomerOrder">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="OD" sql:relation="Sales.SalesOrderDetail" maxOccurs="unbounded" sql:relationship="OrderOrderDetails" sql:hide="1">
<xsd:complexType>
<xsd:attribute name="SalesOrderID" type="xsd:string"/>
<xsd:attribute name="ProductID" type="xsd:string"/>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="CustomerID" type="xsd:string"/>
<xsd:attribute name="OID" sql:field="SalesOrderID"
type="xsd:string"/>
<xsd:attribute name="OrderDate" type="xsd:date"/>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="CID" sql:field="CustomerID"
type="xsd:string"/>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Ha XPath-lekérdezést (például /Customers[@CID="1"]) ad meg ehhez a sémához, a létrehozott XML-dokumentum nem tartalmazza az <OD> elemet és annak gyermekeit, ahogyan az ebben a részleges eredményben látható:
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
<Customers CID="1">
<Order CustomerID="1" OID="43860" OrderDate="2001-08-01" />
<Order CustomerID="1" OID="44501" OrderDate="2001-11-01" />
<Order CustomerID="1" OID="45283" OrderDate="2002-02-01" />
<Order CustomerID="1" OID="46042" OrderDate="2002-05-01" />
</Customers>
</ROOT>