This document provides an overview and demonstration of Oracle's .NET stored procedures and Oracle Developer Tools for Visual Studio .NET. It outlines the key features and benefits, demonstrates the developer tools through examples, and discusses how to write, deploy, and debug .NET stored procedures within Oracle Database. The presentation is intended for informational purposes only and should not be relied upon for purchasing decisions.

1. “This presentation is for informational purposes only and may not be incorporated into a contract or agreement.”

2. The following is intended to outline our general product direction. It
is intended for information purposes only, and may not be
incorporated into any contract. It is not a commitment to deliver any
material, code, or functionality, and should not be relied upon in
making purchasing decision. The development, release, and timing
of any features or functionality described for Oracle’s products
remains at the sole discretion of Oracle.

4. Christian Shay
Principal Product Manager
.NET and Windows
“This presentation is for informational purposes only and may not be incorporated into a contract or agreement.”

5. Introducing:
.NET Stored Procedures for
Oracle Database 10g Release
2 and Oracle Developer
Tools for Visual Studio .NET

6. Agenda
• Oracle Developer Tools for Visual Studio .NET
• Overview
• Demo - drill down
• Oracle Database Extensions for .NET
• Overview
• Demo – My First SP
• Tuning and Data Access
• Demo – Data Access in a SP
• Demo – Debugging a .NET SP

7. Windows Development
Environment Support
Oracle Developer
Tools for VS.NET
IIS
MTS/
Develop C++, C#, Deploy (ASP
COM+
Visual Studio VB .NET ASP.NET)
Environment Application
Application
IIS
Deploy
Database
Development
ODP.NET
Oracle DB
Extensions
For .NET Oracle Services for MTS

8. Oracle Developer Tools for Visual
Studio .NET
• Tightly integrated “Add-in” for Visual Studio .NET
• Oracle is a premier-level partner in the Microsoft
Visual Studio Industry Partner (VSIP) Program
• Available for free download now
• http://otn.oracle.com/dotnet

9. Develop on Windows, Database on
any Platform
Oracle Developer
Oracle Developer
Windows
Tools for VS.NET
Linux
Visual Studio
Visual Studio
Environment
Environment
Unix
Windows Other
Oracle 10g, 9i, or 8i

10. Benefits
• Easy to learn and intuitive
• Leverage SQL Server development experience
• Powerful features that enhance productivity – e.g.
designers, auto code generation
• Exposes latest and greatest Oracle functionality
• Stay in Visual Studio for project lifecycle

11. Feature Overview
• Oracle Explorer – browse and alter schema
• Wizards and Designers
• Automatic code generation
• PL/SQL Editor with IntelliSense
• Oracle Data Window
• Oracle Query Window (ad hoc SQL)
• .NET Stored Procedure Deployment Wizard
• Integrated help system – SQL, PL/SQL keywords

12. D E M O N S T R A T I O N
Oracle Developer
Tools - Drill Down

13. Oracle Explorer
• Tree control, similar to “Server Explorer”
• View Oracle schema objects
• Generate SQL for schema objects
• Filter hides unwanted schema objects
• A starting place for most tasks
• View, alter, create schema objects
• Auto generate code
• View and edit Oracle data
• Run stored procedures and functions

14. Oracle Explorer

15. Designers and Wizards
• Table Designer
• View Designer
• Stored Procedure/Function Wizard
• Package Wizards
• Sequence Designer
• Synonym Designer
• Trigger Designer
• Data Adapter Wizard

16. Table Designer

17. Automatic Code Generation
• Drag and drop a schema object from Oracle Explore
• Generated code uses OracleDataAdapter class
(ODP.NET)
• Data Adapter Wizard can be run to customize
• Generate “typed datasets” as needed

18. PL/SQL Code Editor
• Syntax Coloring
• Collapsible regions
• IntelliSense
• Context sensitive help for SQL/PLSQL keywords
• Intelligent error display in task list
• Context-sensitive help for Oracle error numbers

19. PL/SQL Code Editor

20. Data Window
• View and update table data
• Run stored procedures and view data
• Supports Oracle data types
• View complex data types such as Ref Cursors

21. Data Window

22. Oracle Query Window
• Execute “ad hoc” SQL
• Drag and drop objects from Oracle Explorer to
generate SQL
• Result of select statements in grid or text format
• Execute multiple statements in a row
• Run scripts (“@myscript.sql”)

23. Integrated Online Help
• Getting started
• Walkthroughs
• Oracle Developer Tools Reference Guide
• Context sensitive help for UI elements
• Context sensitive SQL and PLSQL keywords
• Oracle Error Manual
• Oracle SQL Reference Guide
• Oracle PL/SQL Reference Guide

24. Integrated Online Help

25. Coming Soon – CY 2005
• PL/SQL Debugging
• Visual Studio .NET 2005 support
• Many other features

26. Agenda
• Oracle Developer Tools for Visual Studio .NET
• Overview
• Demo - drill down
• Oracle Database Extensions for .NET
• Overview
• Demo – My First SP
• Tuning and Data Access
• Demo – Data Access in a SP
• Demo – Debugging a .NET SP

27. Oracle Database Extensions
for .NET
• Oracle 10g Release 2 on Windows
• Write Microsoft Visual C# or Visual Basic .NET
stored procedures/functions
• Build assembly in Visual Studio .NET
• Deploy from Visual Studio .NET using .NET
Deployment Wizard

28. Architecture

29. Write .NET Stored Procedures for
Oracle
Oracle Developer
Developer
Tools for VS.NET
Visual Studio
Visual Studio Client
Client
Environment
Environment Application
Application
Develop
Invoke
C#,VB.NET,C++
C#,VB.NET,C++
Server Project
Server Project
(Use ODP.NET
(Use ODP.NET Invoke Stored
Stored
if required)
if required) Procedure,
Procedure,
SQL ..
SQL ..
Build Deploy
Assembly
Assembly Oracle DB
foo.dll
foo.dll
(proc sp)
(proc sp)
Extensions
Stored Proc for .NET
for .NET

30. Supported Platforms
• Windows only
• .NET Framework 1.1
• Oracle 10.2 or later

31. When to use
• Ease of development
• Computationally intensive code
• Leverage .NET programming expertise
• Leverage existing .NET code libraries
• Windows platform only

32. Install
• “Custom” install of “Oracle Database
Extensions for .NET” is required
• DBCA performs configuration
• CLR Service created and started
• Service is named <OracleHomeName>ClrAgnt

33. Creating a .NET Stored
Procedure
1. Use Visual Studio .NET to build a .NET
procedure or function in the usual way
2. If data access is required, use ODP.NET
classes
3. Result is a .NET assembly
4. Run .NET Stored Procedure Deployment
Wizard (included with Oracle Developer Tools)
5. Call .NET stored procedure as you would any
other Oracle stored procedure

34. Stored Procedure
Requirements
• Be declared a public static method.
• Not be a constructor or a destructor.
• Use parameter types that are compatible with
the Oracle native database types.

35. Security Levels
• Safe - Access only to database resources.
• External - Read or write to local files, and
access to network resources such as sockets
and internet nodes
• Unsafe- Unrestricted execution including
execution of unmanaged code. It is a superset
of all other security levels.

36. D E M O N S T R A T I O N
Your First .NET SP

37. OraCLRAgent Service
• Multithreaded Agent Architecture
• Optimized for security and performance
• A separate multithreaded process is started for
each system identifier
• Each TNS listener that is running on a system
listens for incoming connection requests for a set
of SIDs.
• As system load thresholds are met, additional
processes are spawed

38. Performance Tuning
• Edit Service <OracleHomeName>ClrAgnt
• Example: ORACLE_HOMEbinoraclragnt.exe
agent_sid=CLRExtProc max_task_threads=5

39. Performance Tuning
• max_sessions – (25) Number of maximum
sessions
• max_task_threads – (6) Number of maximum
task threads
• max_dispatchers – (2) Number of maximum
dispatchers

40. ODP.NET Server Side
Differences
• Failover/Notifications, Transaction and
Connection classes have differences
• No transactions can be started, committed, or
rolled back from within a .NET SP that uses
the default connection of the caller
• Regular transaction symantics apply if a new
connection is opened in the SP

41. D E M O N S T R A T I O N
.NET SP Data
Access

42. D E M O N S T R A T I O N
.NET SP
Debugging

43. Next Steps
• .NET Developer Center - http://otn.oracle.com/dotnet
• Visit our booth in the demogrounds:
• Oracle Database 10g area - Moscone South
• More .NET and Windows sessions:
• ODP.NET: New Features in ADO.NET 2.0 and Oracle
Database 10g Release 2
– NEXT! (Today 4:30 PM 304 Moscone South)
• Oracle Database on Windows: Best Practices
Thursday, 2:30PM in 304 Moscone South
• OTN Ask the Experts
Wednesday, 4PM – OTN Lounge, Moscone West
• E-mail me: christian.shay@oracle.com

44. Q
&
QUESTIONS
A
ANSWERS

45. “This presentation is for informational purposes only and may not be incorporated into a contract or agreement.”