Melhores práticas

Uso de um procedimento de armazenamento com o OracleRefCursor

Ao usar procedimentos armazenados no Oracle, certifique-se de que o REF CURSOR esteja corretamente associado à variável Oracle.ManagedDataAccess.Types.OracleRefCursor.

Para fazer isso, você precisa garantir que o número de parâmetros e seu tipo correspondam aos configurados na propriedade Parâmetros da atividade Run Query.

Você pode obter o conteúdo do cursor usando a atividade Invoke Code ou pode passá-lo a outra consulta de banco de dados como um parâmetro de entrada. Aqui está um exemplo de Invoke Code para convertê-lo em uma tabela de dados:

Oracle.ManagedDataAccess.Client.OracleDataReader reader2 = myRefCursor.GetDataReader();
                dt = new DataTable();
                dt.Load(reader2);

Você deve descartar o cursor quando terminar com ele. Você pode fazer isso com a atividade Invoke Code (myRefCursor.Dispose), com a atividade Invoke Method do pacote de atividades System ou por meio de um comando SQL que você executa.

Connection strings for different database systems

This guide provides sample connection strings for the Connect to Database activity, enabling you to connect to various databases using native and ODBC drivers. It includes examples for Microsoft SQL Server and popular ODBC drivers such as MySQL, Oracle, and PostgreSQL. Follow best practices to ensure secure and efficient database connectivity.

Microsoft SQL Server

Common connection string formats for Microsoft SQL Server when using the Microsoft.Data.SqlClient

1. Using SQL Server authentication:

Data Source=SERVER_NAME;Initial Catalog=DATABASE_NAME;User ID=USERNAME;Password=PASSWORD;

2. With a specific port:

Data Source=SERVER_NAME,PORT_NUMBER;Initial Catalog=DATABASE_NAME;User ID=USERNAME;Password=PASSWORD;

3. Using the ODBC driver

Driver={ODBC Driver 18 for SQL Server};Server=SERVER_NAME;Database=DATABASE_NAME;Uid=USERNAME;Pwd=PASSWORD;Encrypt=yes;TrustServerCertificate=no;

You can learn more about it via the official Microsoft documentation page here.

Excel file

Driver={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};DBQ=C:\full\path\to\the\sampleFile.xlsx;

Oracle Managed Data Access

Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XEPDB1)));User II=system;Password=your_password;

You can learn more about it via the official Microsoft documentation page here.

Driver Unicode do ODBC 8.3 para SQL

Driver={MySQL ODBC 8.3 Unicode Driver};Server=SERVER_NAME;Database=DATABASE_NAME;User=USERNAME;Password=PASSWORD;Option=3;

You can learn more about it viat the official MySQL documentation page here.

Driver SQL ODBC 8.3 ANSI

Driver={MySQL ODBC 8.3 ANSI Driver};Server=SERVER_NAME;Database=DATABASE_NAME;User=USERNAME;Password=PASSWORD;Option=3;