sys.dm_exec_xml_handles (Transact-SQL)
Dotyczy:
programu SQL ServerAzure SQL Managed Instance
Zwraca informacje o aktywnych uchwytach, które zostały otwarte przez sp_xml_preparedocument.
Składnia
dm_exec_xml_handles (session_id | 0 )
Argumenty
session_id | 0,
Identyfikator sesji. Jeśli określono session_id, ta funkcja zwraca informacje o uchwytach XML w określonej sesji.
Jeśli określono wartość 0, funkcja zwraca informacje o wszystkich dojściach XML dla wszystkich sesji.
Zwracana tabela
| Nazwa kolumny | Typ danych | Opis |
|---|---|---|
| session_id | Identyfikator sesji sesji, która zawiera ten uchwyt dokumentu XML. | |
| document_id | Identyfikator dojścia dokumentu XML zwrócony przez sp_xml_preparedocument. | |
| namespace_document_id | Wewnętrzny identyfikator dojścia używany dla skojarzonego dokumentu przestrzeni nazw, który został przekazany jako trzeci parametr do sp_xml_preparedocument. Wartość NULL, jeśli nie ma dokumentu przestrzeni nazw. | |
| sql_handle | |
Dojmij do tekstu kodu SQL, w którym zdefiniowano uchwyt. |
| statement_start_offset | Liczba znaków do aktualnie wykonywanej partii lub procedury składowanej, w której występuje wywołanie sp_xml_preparedocument. Można używać razem z sql_handle, statement_end_offseti funkcją dynamicznego zarządzania sys.dm_exec_sql_text w celu pobrania aktualnie wykonywanej instrukcji dla żądania. | |
| statement_end_offset | Liczba znaków do aktualnie wykonywanej partii lub procedury składowanej, w której występuje wywołanie sp_xml_preparedocument. Można używać razem z sql_handle, statement_start_offseti funkcją dynamicznego zarządzania sys.dm_exec_sql_text w celu pobrania aktualnie wykonywanej instrukcji dla żądania. | |
| creation_time | data/godzina | Sygnatura czasowa wywołania sp_xml_preparedocument. |
| original_document_size_bytes | bigint | Rozmiar nieparzysty dokumentu XML w bajtach. |
| original_namespace_document_size_bytes | bigint | Rozmiar dokumentu przestrzeni nazw XML nieparzysty w bajtach. Wartość NULL, jeśli nie ma dokumentu przestrzeni nazw. |
| num_openxml_calls | bigint | Liczba wywołań OPENXML z tym uchwytem dokumentu. |
| row_count | bigint | Liczba wierszy zwracanych przez wszystkie poprzednie wywołania OPENXML dla tego dojścia dokumentu. |
| dormant_duration_ms | bigint | Liczba milisekund od ostatniego wywołania OPENXML. Jeśli funkcja OPENXML nie została wywołana, zwraca milisekundy od wywołania sp_xml_preparedocument. |
Uwagi
Okres istnienia sql_handles używany do pobierania tekstu SQL, który wykonał wywołanie w celu sp_xml_preparedocument przeżywa buforowany plan używany do wykonywania zapytania. Jeśli tekst zapytania nie jest dostępny w pamięci podręcznej, nie można pobrać danych przy użyciu informacji podanych w wyniku funkcji. Taka sytuacja może wystąpić w przypadku uruchamiania wielu dużych partii.
Uprawnienia
Wymaga uprawnienia WYŚWIETL STAN SERWERA na serwerze, aby wyświetlić wszystkie sesje lub identyfikatory sesji, które nie są własnością elementu wywołującego. Obiekt wywołujący zawsze może zobaczyć dane dla własnego bieżącego identyfikatora sesji.
Uprawnienia dla programu SQL Server 2022 i nowszych
Wymaga uprawnienia WYŚWIETL STAN WYDAJNOŚCI SERWERA na serwerze.
Przykłady
Poniższy przykład wybiera wszystkie aktywne dojścia.
SELECT * FROM sys.dm_exec_xml_handles(0);
Zobacz też
dynamiczne widoki zarządzania i funkcje (Transact-SQL)
dynamiczne widoki zarządzania i funkcje związane z wykonywaniem (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)