Deixo claro que não irei a fundo sobre a Administração e a Instalação do Oracle Database , neste artigo estou usando a versão 10g dentro de uma máquina virtual com CentOS 5.3, mas iremos abordar nesta primeira parte sobre a instalação do ODAC (Oracle Data Access Components) e alguns dos principais conceitos sobre o Oracle Database.

Cenário Atual

• Oracle Database 10.2g
  • Enterprise Edition
• Oracle 11g ODAC 11.1.0.7.20 with Oracle Developer Tools for Visual Studio
  • Oracle Developer Tools for Visual Studio 11.1.0.7.20
  • Oracle Data Provider for .NET 2.0 11.1.0.7.20
  • Oracle Providers for ASP.NET 11.1.0.7.20
  • Oracle Database Extensions for .NET 2.0 11.1.0.7.20 — Somente para upgrade
  • Oracle Provider for OLE DB 11.1.0.7.20
  • Oracle Objects for OLE 11.1.0.7.20
  • Oracle Services for Microsoft Transaction Server 11.1.0.7.20
  • Oracle ODBC Driver 11.1.0.7.0
  • Oracle SQL*Plus 11.1.0.7.0
  • Oracle Instant Client 11.1.0.7.0
• Visual Studio 2008
  • .NET Framework 3.5 SP1

Instalando o ODAC

Passo 1 -> Vamos fazer o download do ODAC no link http://www.oracle.com/technology/software/tech/windows/odpnet/index.html – A última versão até o lançamento deste post era a 11.1.0.7.20, eu recomendo fazer o download da versão completa como descrita acima.

Passo 2 -> Descompacte o arquivo e instale-o com o OUI (Oracle Universal Installer).
Nota: Não é recomendada a instalação em diretórios onde contenham espaços no nome da pasta como “Program Files” então eu recomendo colocar em “C:/Oracle”

Passo 3 -> Após instalado não está tudo pronto, é necessário fazer algumas configurações básicas:

• 1 – Variáveis:
  • 1.1 - %ORACLE_HOME% é recomendável configurá-la (Ex. C:\Oracle\product\11.1.0\client_2)
  • 1.2 - %PATH% se eu não estou muito enganado assim que você termina a instalação já é definida nessa variável um caminho similar a esse:
    C:\Oracle\product\11.1.0\client_2\
    mas eu adicionei o caminho
    C:\Oracle\product\11.1.0\client_2\bin
    é bom para quem gosta de usar o SQL-Plus
• 2 – SQL*NET Setup
  • 2.1 - EZCONNECT – O EZCONNECT ou TNSNAME pode ser usado para conectar ao Oracle para execução dos scripts de confiuração do Oracle Providers ASP.NET bem como para utilizar os Providers após instalados conectando eles com o Oracle Database. Para conectar ao database usando qualquer abordagem, o arquivo %ORACLE_HOME%\Network\Admin\sqlnet.ora deve ser criado contendo:

    NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT)
    

    Para habilitar a autenticação usando o usuário do seu Sistema Operacional, é necessário incluir a seguinte linha:

    SQLNET.AUTHENTICATION_SERVICES = (NTS)
    

    Depois de configurado, você pode usar o EZCONNECT.

    No “data source” deve ser especificada no seguinte formato (Nenhum outro arquivo de configuração é necessário):

    [//]host[:port][/service_name][/server][/instance_name]
    

  • 2.2 -TNSNAME – É um arquivo de configuração que contém o net service name mapeado para o descritor do conector. Resumindo, é utilizado para criar um alias para a conexão com o database. Para utilizar o TNSNAME é necessário criar o arquivo:%ORACLE_HOME%\Network\Admin\tnsnames.ora – Segue abaixo um exemplo de configuração de um alias:

    orcl =
    (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.113)(PORT = 1521))
    (CONNECT_DATA =
    (SERVER = DEDICATED)
    (SERVICE_NAME = orcl.rio.com)
    )
    )
    

    O protocolo, host, port e service name no exemplo a cima deve ser modificado apropriadamente. Nesse caso foi criado um alias chamado “orcl” que deve ser especificado no “data source” do string de conexão.

    Na segunda parte deste artigo nós usaremos esse TNSNAME durante os exemplos.

• 3 – Executando o Script SQL
  • 3.1 - Essa parte é importante se você for utilizar Providers no seu projeto. Antes de você executar qualquer Oracle Provider para ASP.NET é necessário executar os scripts SQL de configuração.
  • 3.2 - É importante informá-los que o script vai criar tabelas, stored procedures, views e roles. Eles vão pertencer ao usuário que estiver executando os scritps. Antes de mais nada, verifique se seu usuário tem os seguintes privilégios:
    • CHANGE NOTIFICATION
    • CREATE JOB
    • CREATE PROCEDURE
    • CREATE PUBLIC SYNONYM
    • CREATE ROLE
    • CREATE SESSION
    • CREATE TABLE
    • CREATE VIEW
    • DROP PUBLIC SYNONYM
  • 3.3 - Você pode executar os scripts com o SQL*Plus ou usar o Oracle Developer Tools (ODT) para Visual Studio 2008. se você for usar o SQL*Plus, segue uma boa dica nesse post: “Prompt do DOS Rápido“, neste exemplo vamos usar o ODT.
    • 3.3.1 - Abra o Visual Studio 2008, vá em “tools” em seguida em “Run SQL*Plus Script“
    • 3.3.2 - Na janela do “Run SQL*Plus Script” clique no botão  ”New Connection“.
    • 3.3.3 - Na janela “Connection Proprierties” selecione ”Oracle Database Server (Oracle ODP.NET)” para Data Source e “Oracle Data Provider for .NET” para Data Provider. Selecione o alias TNS no Data Source. Se nenhum alias estiver no drop-down digite o seu alias TNS conforme configurado no item 2.2. Digite o usuário e senha, ou selecione “Use Windows integrated authentication“. Clique no botão “Test Connection” para testar a conexão. Se retornar uma mensagem de sucesso! Clique no botão OK.
    • 3.3.4 - De volta para a janela do ‘Run SQL*Plus Script‘, procure e selecione o script SQL a ser executado. Geralmente a localização desses scripts ficam em
      “%ORACLE_HOME%\ASP.NET\SQL“
    • 3.3.5 - O script “InstallOracleASPNETCommon.sql” deve ser executado primeiro, antes de executar qualquer outro script para ”Oracle Providers for ASP.NET“, depois disso não é mais necessário executar esse script novamente. Não é necessário executar todos os scripts. Por exemplo, se sua aplicação utilizar somente o “Oracle’s Membership provider“, execute somente o “InstallOracleASPNETCommon.sql” e o “InstallOracleMembership.sql“, nesta ordem.
    • 3.3.6 - Caso você deseje instalar todos os Providers execute unicamente o “InstallAllOracleASPNETProviders.sql” , para usuários do Oracle Database 9 é necessário realizar algumas modificações dentro deste arquivo (abra e modifique).
    • 3.3.6 - Para a desinstalar os Providers o processo é exatamente o mesmo, os scripts “Uninstall” correspondem aos “Install”.

Observações e Notas:

• 4 – machine.config
  Após a instalação do “Oracle Providers for ASP.NET”, o arquivo “%windir%\Microsoft.NET\Framework\v2.0.50727\CONFIG\machine.config” é modificado para atenderem aos requisitos dos novos ASP.NET providers. Um alias “connection string” é criado com o nome
  “OraAspNetConString“, do qual é referenciado por cada “Oracle
  Providers for ASP.NET“. A baixo segue o exemplo de uma típica configuração feita no arquivo “machine.config“:

  <configuration>
  ...
  <connectionStrings>
  ...
  <add name="OraAspNetConString" providerName="Oracle.DataAccess.Client" connectionString=" " />
  </connectionStrings>
  ...
  <system.web>
  ...
  <membership>
  <providers>
  <add name="OracleMembershipProvider" type="Oracle.Web.Security.OracleMembershipProvider, Oracle.Web, Version=2.111.7.20, Culture=neutral, PublicKeyToken=89b483f429c47342" connectionStringName="OraAspNetConString" applicationName="" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
  ...
  </providers>
  </membership>
  ...
  </system.web>
  ...
  </configuration>
  

  O exemplo a cima mostra somente a entrada do “Oracle Membership Provider“. Os outros Providers vão ter uma sintax semelhante a esta.

  Se o alias “OraAspNetConString” no machine.config vai ser usado pelo seu aplicativo, você deve atribuir uma “connection string” válida no “machine.config” ou sobrescrever essas configurações no “web.config”.

• 5 – Web.config Você pode usar o arquivo de configuração “web.config” para sobrescrever as configurações atuais do arquivo “machine.config” como mencionado anteriormente. Alguns exemplos são apresentados no “Oracle Providers for ASP.NET Developer’s Guide” (pdf).

Links

• Configurando Providers no ASP.NET
• OTN Oracle

Ao instalar o Visual Studio você tem basicamente três maneiras de acesso a base de dados são elas o: OLE DB, SQL e OBDC.

Cada objeto do ADO.NET tem uma versão para cada driver de acesso dados, sendo assim se você for usar SQL Server vai ter o objeto SqlConnection, o OLE vai ter o OleDBConnection e assim por diante.

Todos os recursos da arquitetura .NET podem ser acessados através de Namespaces:

System.Data – essa você vai usar em 100% das vezes, obtém as classes principais pra usar DataSet e DataRelation.

System.Data.Common – Essa como o próprio nome disse são calsses comuns

System.Data.OleDb – classes para conexão com o fornecedor OLE DB.

E essa lista se estende, principalmente quando é instalado drivers de outros banco de dados, para conhecer não só essas, mas todas as classes e namespaces disponíveis no seu Visual Studio pressione CTRL + W + J para abrir o Object Browser.

Esse é uma imagem sobre a Arquitetura ADO.NET retirada da documentação oficial.

Arquitetura ADO.NET

Descrevendo os principais componentes:

Antes de mais nada é necessário entender que esses componentes são comuns a todos os tipos de conexões com o banco de dados, se você for se conectar a um servidor SQL Server vai usar o SqlConnection, ao Mysql vai utilizar o MySqlconenction, o Oracle o OracleConnection e assim por diante.

Connection -> Como você já deve ter adivinhado esse objeto serve somente para fazer a conexão com o Banco de Dados, cada conexão com qualquer Banco de dados Requer um String de Conexão, você pode consultar esse site http://www.connectionstrings.com/ para ver as mais variadas Connection String para diversos Banco de Dados.

Command -> Esse objeto representa um Statement SQL ou Stored Procedure para ser excutado no banco de dados, normalmenete você indica a ele qual conexão vi utilizar e passa a Query para ser executada no banco de dados, simples assim.

DataReader -> Esse objeto é excelente para leitura de dados rápida, com ele você fica limitado a ler os dados somente para frente, read-only, não pode ser usado desconectado e é ultra rápido.

DataAdapter -> Este objeto é o oposto do DataReader, com ele você pode obter dados de seu Banco de Dados, Fazer consultas, acessar a fonte de dados através de uma conexão, preencher um DataSet, ler os dados do DataSet, Verificar quais dados foram alterados, enviar ao banco de dados os dados para atualizar na fonte os mesmo, uff.. pelo que você já viu vai utilizar bastante ele.

DataSet -> Á.. esse objeto “é o que há” dentro da arquitetura ADO.NET (bem é o que diz a Microsoft) ele é a representação ou cópia fiel de seu banco de dados dentro da aplicação! Isso mesmo dentro dele você tem uma tabela, um relacionamento, linhas, colunas, assim como um banco de dados, o legal de tudo é que você pode combinar diferentes fonte de dados no mesmo DataSet, assim você pode ter tabelas do MySql, junto com “tabelas” de um arquivo do Excel, junto com mais um monte de coisas!!

Você normalmente utiliza o DataAdapter para preencher um DataSet, depois disso você pode até fechar sua conexão e modificar os dados sem estar ligado diretamente com a sua fonte de dados! Muito legal né? Imagina o quanto isso deve consumir de memória se não for feito um bom planejamento?!?! Rsrsrs… mas é muito interessante!

Bem.. isso é um pequena introdução a arquitetura, na próxima vamos ver alguns exemplos práticos. para os microsoftianos já deixo avisado que não utilizarei o SQL Server.. na maioria das vezes usaremos o MySql, SQLite e Oracle…

Links úteis:

http://msdn.microsoft.com/en-us/library/h43ks021(VS.71).aspx (Documentação Oficial do ADO.NET)

http://www.connectionstrings.com/ (Exemplos de String de Conexão)

http://download.oracle.com/docs/cd/B28359_01/appdev.111/b28844/toc.htm (Guia do Desenvolvedor .NET da Oracle)

http://dev.mysql.com/doc/refman/5.1/en/connector-net.html (Manual de Referência do MySql para conexão com .NET)