Share via


Functoid de búsqueda en base de datos

 

Use el functoid Búsqueda de base de datos ( icono que representa el functoid Búsqueda de base de datos). Para extraer una fila de una tabla de base de datos como un conjunto de registros de Microsoft ActiveX Data Objects (ADO).

Entrada

Parámetro 1: valor que se buscará en la base de datos, tabla y columna especificadas.

Parámetro 2: cadena de conexión de ActiveX Data Objects .NET (ADO.NET) para un origen de datos compatible en el que se realizará la búsqueda. Los orígenes de datos ODBC (incluidos los orígenes DSN) no se admiten. Para hacer referencia a un archivo de vínculo de datos universal (UDL) de OLE DB para especificar la conexión, use el parámetro Nombre de archivo para especificar la ruta de acceso completa y el nombre de archivo del archivo UDL que contiene la información de la cadena de conexión.

Nota

Debido a la sobrecarga asociada al análisis de un archivo UDL, se recomienda usar una cadena de conexión que no haga referencia a un UDL. Como alternativa, genere una biblioteca del asistente que devuelva una cadena de conexión apropiada cuando la llame el functoid de secuencias de comandos.

Nota

Recomendamos comprobar que el origen de datos de destino cumpla los objetivos de rendimiento de la solución de BizTalk Server.

Parámetro 3: nombre de la tabla de la base de datos en la que se realizará la búsqueda.

Parámetro 4: nombre de la columna de la tabla en la que se realizará la búsqueda.

Resultados

Salida 1: conjunto de registros ADO.NET que contiene el valor buscado. Independientemente del número de filas que hayan coincidido con el valor especificado, solo se incluirá la primera de ellas en el conjunto de registros.

Comentarios

Use este functoid junto con los functoids Extractor de valor y Devolución de error.

Importante

Para evitar los riesgos de seguridad asociados al hecho de que la contraseña de Microsoft SQL Server esté visible como parte de la cadena de conexión que se proporciona como parámetro de entrada 2 o mediante un archivo UDL, se recomienda usar la autenticación con Windows NT en lugar de la de SQL Server.

Prácticas recomendadas

Codificar las cadenas de conexión de SQL puede dar lugar a gastos de mantenimiento y problemas de servicio. Para evitarlos, puede configurar externamente orígenes de datos en el functoid Búsqueda en base de datos. Puede obtener la cadena de conexión SQL (parámetro 2) de un functoid de secuencias de comandos, que se pueden vincular al functoid Búsqueda en base de datos.

En la siguiente figura, puede ver que el segundo parámetro del functoid Búsqueda en base de datos se pasa a través de una secuencia de comandos presente en el functoid de secuencias de comandos.

Functoid Búsqueda de base de datos

Puede usar las secuencias de comandos siguientes en el functoid de secuencia de comandos.

public string connectionString1()  
        {  
            string serverName = Environment.MachineName;  
            string connectionString1 = string.Format("Data Source = {0}; Initial Catalog = myDataBase; Integrated Security = SSPI;", serverName);  
            return connectionString1;  
        }  
  
public string connectionString2(string password)  
        {  
            string serverName = Environment.MachineName;  
            string userdomain = Environment.UserDomainName;  
            string userName = Environment.UserName;  
            string connectionString2 = string.Format(@"Data Source={0};Initial Catalog=myDataBase;Integrated Security=SSPI;User ID={1}\{2};Password={3};", serverName, userdomain, userName, password);  
            return connectionString2;  
        }  
  

Consulte también

Referencia a functoids de bases de datos
Functoids de base de datos
Cómo agregar functoids básicos a una asignación