Explorar, buscar y obtener metadatos de SQL Server

Los metadatos que muestra el adaptador de Microsoft BizTalk para SQL Server de la base de datos de SQL Server describen la estructura de mensajes para comunicarse con la base de datos de SQL Server mediante el adaptador. El adaptador de SQL admite dos interfaces para recuperar metadatos.

• MetadataExchange proporcionado por Windows Communication Foundation (WCF). WCF proporciona un punto de conexión de intercambio de metadatos para todos los enlaces WCF, lo que permite a los clientes obtener metadatos de la base de datos de SQL Server.

• IMetadataRetrievalContract proporcionado por el SDK del adaptador de línea de negocio (LOB) de Microsoft Windows Communication Foundation (WCF), que admite las funcionalidades de exploración y búsqueda de metadatos del adaptador.

  El adaptador de SQL muestra los artefactos de base de datos SQL Server y las operaciones respectivas que los clientes del adaptador pueden invocar. El adaptador también muestra las operaciones (como ExecuteNonQuery, ExecuteReader y ExecuteScalar) que se pueden usar para realizar operaciones específicas en la base de datos SQL Server. Estas operaciones se explican más adelante en este tema.

Nota

El adaptador de SQL muestra artefactos en todos los esquemas de la base de datos SQL Server a la que tiene acceso el usuario conectado actualmente. Esto implica que, aparte del esquema predeterminado (dbo), los clientes del adaptador también pueden realizar operaciones en artefactos de otros esquemas de la base de datos SQL Server siempre que las credenciales de usuario usadas para conectarse mediante el adaptador de SQL tengan acceso a esos esquemas de la base de datos SQL Server. Para obtener información sobre un esquema en SQL Server base de datos, vea https://go.microsoft.com/fwlink/?LinkId=130148.

Puede usar los clientes del adaptador para examinar, buscar y recuperar metadatos mediante:

• Creación de un proyecto de BizTalk en Visual Studio

• Uso del modelo de servicio WCF

• Uso del modelo de canal WCF

  Al usar un proyecto de BizTalk, debe usar el Asistente para agregar metadatos del complemento de proyecto de BizTalk del servicio adaptador o Agregar metadatos de adaptador para generar metadatos para las operaciones que desea realizar en la base de datos de SQL Server. Al usar el modelo de servicio WCF, debe usar el complemento Agregar referencia de servicio de adaptador de Visual Studio para generar las clases de proxy para realizar operaciones en la base de datos SQL Server. Para obtener más información sobre la exploración, la búsqueda y la recuperación de metadatos mediante el complemento Consumir servicio de adaptador, el Asistente para agregar metadatos del adaptador o el complemento Agregar referencia de servicio de adaptador, vea Obtener metadatos para operaciones de SQL Server en Visual Studio mediante el adaptador de SQL.

Examinar metadatos

El adaptador de SQL permite a los clientes del adaptador examinar las tablas de base de datos, las vistas, los procedimientos almacenados y las funciones que están disponibles en la base de datos SQL Server. Como parte de la operación de exploración de metadatos, el adaptador también muestra las operaciones que se pueden realizar en la base de datos de SQL Server, incluidas algunas operaciones personalizadas compatibles con los adaptadores. Estas operaciones están disponibles en El complemento Consumir servicio de adaptador, el Asistente para agregar metadatos del adaptador o el complemento Agregar referencia del servicio de adaptador. El adaptador de SQL muestra las siguientes operaciones:

• Las operaciones en tablas, vistas, procedimientos, funciones escalares y funciones con valores de tabla. Por ejemplo, el adaptador de SQL puede mostrar las operaciones Insertar, Actualizar, Seleccionar y Eliminar para la tabla EMPLOYEE.

• La operación Establecer<nombre> de columna para tablas y vistas que permite a los clientes del adaptador escribir valores de datos grandes de forma de streaming. La operación Set solo se devuelve para esas tablas y vistas que contienen columnas con cualquiera de los siguientes tipos de datos: Varchar(Max), Nvarchar(Max) o Varbinary(Max). Para obtener más información, vea Operaciones en tablas y vistas que contienen tipos de datos de gran tamaño mediante el adaptador de SQL.

• Las operaciones ExecuteNonQuery, ExecuteReader y ExecuteScalar que permiten a los clientes del adaptador ejecutar instrucciones SQL arbitrarias en SQL Server. Para obtener más información sobre estas operaciones, vea Compatibilidad con las operaciones ExecuteNonQuery, ExecuteReader y ExecuteScalar.

• Las operaciones de sondeo y notificación para recibir mensajes entrantes de SQL Server. Para obtener información sobre la operación de sondeo, vea Compatibilidad con llamadas entrantes mediante sondeo; para obtener información sobre la operación de notificación, vea Consideraciones para recibir notificaciones de consulta mediante el adaptador de SQL.

  Para obtener más información sobre cómo se clasifican los metadatos, consulte Identificadores de nodo de metadatos.

Buscar metadatos

Con el adaptador de SQL, es posible realizar una consulta de búsqueda en la base de datos SQL Server mediante las expresiones de búsqueda SQL Server compatibles con el operador LIKE. Por ejemplo, los clientes de adaptador pueden usar una expresión de búsqueda como "EMP%" para obtener tablas a partir de EMP. El adaptador lo convierte en la siguiente consulta SQL:

SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE 'EMP%'

En la tabla siguiente se enumeran los caracteres especiales que el adaptador de SQL puede usar para la búsqueda y su interpretación.

Carácter especial	Interpretación
_ (carácter de subrayado)	Coincide exactamente con un carácter. Por ejemplo, "A_" coincide con "AB", "AC", "AD".
% (porcentaje)	Coincide con cero o más caracteres. Por ejemplo, "A%" coincide con "A", "AB", "ABC".
[ ]	- Escape del significado especial de _ y %. : especifica un intervalo o un conjunto de caracteres que se van a presentar. Por ejemplo: - %[%]% coincide con todos los nombres que incluyen un símbolo % . - [a-f] coincide con todos los nombres que tienen caracteres entre e incluyendo "a" y "f". - [abc] coincide con todos los nombres que tienen caracteres "a", "b" y "c".
[^]	Especifica un intervalo o un conjunto de caracteres que no deben estar presentes. Por ejemplo: - [^a-f] coincide con todos los nombres que no tienen caracteres entre e incluyendo "a" y "f". - [^abc] coincide con todos los nombres que no tienen caracteres 'a', 'b' y 'c'.

Importante

El ámbito de búsqueda de metadatos está restringido al nivel inmediatamente bajo el nodo en el que se realiza la operación de búsqueda. Por ejemplo, para buscar una función escalar, debe estar buscando en /Scalar Function/[Schema]. No se admite la búsqueda de varios niveles.

Recuperación de metadatos

Al recuperar metadatos, el adaptador de SQL puede extraer metadatos en un esquema, incluidos todos o un subconjunto de objetos de base de datos con los parámetros de operación y objeto respectivos. El adaptador presenta las entidades de la base de datos SQL Server como nombres de elemento en XML. Dado que los caracteres de subrayado son los únicos caracteres especiales permitidos que se pueden incluir, todos los demás caracteres especiales de los nombres de elemento se codifican mediante caracteres de subrayado. Por ejemplo, emp$name se codifica como emp_x0024_name.

Consulte también

Información general sobre el adaptador de BizTalk para SQL ServerComponer adaptador de BizTalk para SQL Server Obtenermetadatos para operaciones de SQL Server en Visual Studio mediante el adaptador de SQL