Add files via upload

Author: alexkeh

dotnet/CONTRIBUTING.md

@@ -0,0 +1,3 @@
+Copyright (c) Oracle and/or its affiliates. All rights reserved.
+
+Oracle requires that contributors to all of its open-source projects sign the <a href="http://www.oracle.com/technetwork/community/oca-486395.html">Oracle Contributor Agreement (OCA)</a>.

dotnet/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Oracle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dotnet/README.md

@@ -1,5 +1,27 @@
-# .NET based examples
-This folder stores .NET based examples for Oracle Database.
+<H1>Oracle .NET Code Sample Respository</H1>
+<H2>About Oracle .NET</H2>
+This repository provides .NET code samples for Oracle developers, specifically for Oracle Data Provider for .NET (ODP.NET) 
+and other Oracle .NET components. .NET products for Oracle Database are free of charge. They consist of:
+
+<ul>
+<li>Oracle Data Provider for .NET (ODP.NET) - an optimized ADO.NET data access provider to the Oracle database. ODP.NET allows developers to take advantage of advanced Oracle database functionality, including Real Application Clusters, XML DB, and self-updating client caches.</li>
+<li>Oracle Developer Tools for Visual Studio - a tightly integrated design-time "Add-in" for Microsoft Visual Studio that provides full Oracle .NET application lifecycle management, including PL/SQL debugging and schema comparison tools.</li>
+<li>Oracle Providers for ASP.NET - a collection of ASP.NET providers that use Oracle Database as the data source. ASP.NET applications can store various types of website state in an Oracle database, which can then be shared across the application.</li>
+<li>Oracle Database Extensions for .NET - a feature of Oracle Database on Windows that makes it easy to develop, deploy, and run stored procedures and functions written in a .NET managed language</li>
+<li>Oracle TimesTen Data Provider for .NET - ODP.NET support for Oracle TimesTen In-Memory Database (TimesTen) provides fast and efficient ADO.NET data access from .NET client applications to TimesTen databases.</li>
+</ul>
+<H2>Geting Started</H2>
+Oracle .NET components are bundled together and installed as part of Oracle Data Access Components (ODAC). Downloads and installation instructions are available from the <a href="http://www.oracle.com/technetwork/topics/dotnet/downloads/index.html">OTN .NET Tech Center download page</a>. Beginners should download <a href="http://www.oracle.com/technetwork/topics/dotnet/utilsoft-086879.html">32-bit ODAC with Oracle Developer Tools for Visual Studio</a>, which will provide a guided, smoother installation experience. Installation instructions are available as part of each download page. The installation instructions list the software prerequisites for the version downloaded.
+
+<H2>Tutorials</H2>
+For beginning Oracle .NET developers, these <a href="http://www.oracle.com/technetwork/topics/dotnet/for-beginners/index.html">tutorials and videos</a> will assist you in developing .NET applications for Oracle Database. Instructions for compiling, testing, deploying, and running Oracle .NET apps are part of the <a href="https://apex.oracle.com/pls/apex/f?p=44785:24:0::NO::P24_CONTENT_ID,P24_PREV_PAGE:10117,1">Oracle By Example tutorials</a>.
+
+<H2>More Information</H2>
+<ul>
+<li><a href="http://docs.oracle.com/cd/E63277_01/index.htm">Documentation</a></li>
+<li>Code samples are included with the ODAC Oracle Universal Installation. You will find them in the "ODACSamples" directory in the Oracle Client installation home (e.g. d:\app\client\&lt;username&gt;\product\&lt;Oracle version&gt;\client_1\ODACsamples).</li>
+<li>Contibutions to code samples should review <a href="CONTRIBUTING.md">CONTRIBUTING</a> for more details.</li>
+<li>You may use files in this repository only if in compliance with the <a href="LICENSE">LICENSE</a>.</li>
+<li>More Oracle .NET development information can be found at the <a href="http://otn.oracle.com/dotnet">OTN .NET Developer Center</a>.</li>
+</ul>
 
-## dotnet-db-samples
-Legacy repository of .NET based examples.

dotnet/samples/selectjson.cs

@@ -0,0 +1,88 @@
+/* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. */
+
+/******************************************************************************
+ *
+ * You may not use the identified files except in compliance with The MIT
+ * License (the "License.")
+ *
+ * You may obtain a copy of the License at
+ * https://github.com/oracle/Oracle.NET/blob/master/LICENSE
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * NAME
+ * oraclejson.cs
+ *
+ * DESCRIPTION
+ * Inserts one row into a JSON table.
+ * Executes a query against a JSON table.
+ * This sample works with either ODP.NET, Managed Driver or 
+ * ODP.NET, Unmanaged Driver.
+ * 
+ * Requires Oracle Database 12.1.0.2 or higher, which has JSON datatype support.
+ * See http://docs.oracle.com/database/121/ADXDB/json.htm#CACGCBEG
+ * Use SQL below to create the required table or do:
+ *
+ * DROP TABLE j_purchaseorder;
+ * CREATE TABLE j_purchaseorder
+ * (po_document VARCHAR2(4000) CONSTRAINT ensure_json CHECK (po_document IS JSON));
+ * 
+ *
+ *****************************************************************************/
+
+using System;
+using Oracle.ManagedDataAccess.Client;
+//using Oracle.DataAccess.Client;
+
+namespace JsonSample
+{
+ class Program
+ {
+ static void Main(string[] args)
+ {
+ try
+ {
+ // Add your user id, password, and data source
+ string conString = "User Id=<user>;Password=<password>;Data Source=<data source>;";
+
+ // Connect and open a database connection
+ OracleConnection con = new OracleConnection();
+ con.ConnectionString = conString;
+ con.Open();
+
+ // Insert JSON data into database
+ OracleCommand cmd = con.CreateCommand();
+ cmd.CommandText = "INSERT INTO j_purchaseorder (po_document) VALUES (:1)";
+
+ OracleParameter param = new OracleParameter();
+ param.OracleDbType = OracleDbType.Varchar2;
+ param.Value = @"{'id': 1,'name': 'Alex', 'location': 'USA'}";
+ cmd.Parameters.Add(param);
+
+ cmd.ExecuteNonQuery();
+
+ Console.WriteLine("JSON inserted.");
+ Console.WriteLine();
+
+ // Query JSON from database
+ cmd.CommandText = "SELECT po_document FROM j_purchaseorder WHERE JSON_EXISTS (po_document, '$.location')";
+ OracleDataReader rdr = cmd.ExecuteReader();
+
+ rdr.Read();
+ Console.WriteLine(rdr.GetOracleValue(0));
+
+ }
+ catch (Exception ex)
+ {
+ Console.WriteLine(ex.Message);
+ Console.WriteLine(ex.InnerException);
+ }
+
+ }
+ }
+}

dotnet/samples/selectjsonclob.cs

@@ -0,0 +1,94 @@
+/* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. */
+
+/******************************************************************************
+ *
+ * You may not use the identified files except in compliance with The MIT 
+ * License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at
+ * https://github.com/oracle/Oracle.NET/blob/master/LICENSE
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * NAME
+ * oraclejsonclob.cs
+ *
+ * DESCRIPTION
+ * Inserts one row into a JSON table using CLOB storage.
+ * Executes a query against a JSON table using CLOB storage.
+ * This sample works with either ODP.NET, Managed Driver or 
+ * ODP.NET, Unmanaged Driver.
+ * 
+ * Requires Oracle Database 12.1.0.2 or higher, which has JSON datatype support.
+ * See http://docs.oracle.com/database/121/ADXDB/json.htm#CACGCBEG
+ * Use SQL below to create the required table or do:
+ *
+DROP TABLE j_purchaseorder_c;
+-- The extra CHECK clause 'or length(po_document) = 0' clause allows
+-- EMPTY_CLOB() to be inserted into the table. The extra clause is
+-- not needed if you have a database patch for bug 21636362. The
+-- extra 'or' clause will stop the table appearing in
+-- USER_JSON_COLUMNS. EMPTY_CLOB() is currently needed by
+-- node-oracledb for inserting CLOB data.
+CREATE TABLE j_purchaseorder_c (po_document CLOB CHECK (po_document IS JSON or length(po_document) = 0));
+COMMIT;
+ * 
+ *
+ *****************************************************************************/
+
+using System;
+using Oracle.ManagedDataAccess.Client;
+// using Oracle.DataAccess.Client;
+
+namespace JsonClobSample
+{
+ class Program
+ {
+ static void Main(string[] args)
+ {
+ try
+ {
+ // Add your user id, password, and data source
+ string conString = "User Id=<user>;Password=<password>;Data Source=<data source>;";
+ 
+ // Connect and open a database connection
+ OracleConnection con = new OracleConnection();
+ con.ConnectionString = conString;
+ con.Open();
+
+ // Insert JSON data into database using a CLOB
+ OracleCommand cmd = con.CreateCommand();
+ cmd.CommandText = "INSERT INTO j_purchaseorder_c (po_document) VALUES (:1)";
+
+ OracleParameter param = new OracleParameter();
+ param.OracleDbType = OracleDbType.Clob;
+ param.Value = @"{'id': 1,'name': 'Alex', 'location': 'USA'}";
+ cmd.Parameters.Add(param);
+
+ cmd.ExecuteNonQuery();
+
+ Console.WriteLine("JSON inserted.");
+ Console.WriteLine();
+
+ // Query JSON from database
+ cmd.CommandText = "SELECT po_document FROM j_purchaseorder_c WHERE JSON_EXISTS (po_document, '$.location')";
+ OracleDataReader rdr = cmd.ExecuteReader();
+
+ rdr.Read();
+ Console.WriteLine(rdr.GetString(0));
+
+ }
+ catch (Exception ex)
+ {
+ Console.WriteLine(ex.Message);
+ Console.WriteLine(ex.InnerException);
+ }
+
+ }
+ }
+}

dotnet/schemas/scott.sql

@@ -0,0 +1,104 @@
+Rem Copyright (c) 2016 by Oracle Corporation
+Rem
+Rem You may not use the identified files except in compliance with The MIT
+Rem License (the "License.")
+Rem
+Rem You may obtain a copy of the License at
+Rem https://github.com/oracle/Oracle.NET/blob/master/LICENSE
+Rem
+Rem Unless required by applicable law or agreed to in writing, software
+Rem distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+Rem WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+Rem
+Rem See the License for the specific language governing permissions and
+Rem limitations under the License.
+Rem
+Rem NAME
+REM scott.sql
+Rem 
+Rem DESCRIPTION
+Rem SCOTT is a database user whose schema is used for Oracle code demonstrations
+
+
+SET TERMOUT OFF
+SET ECHO OFF
+
+rem CONGDON Invoked in RDBMS at build time. 29-DEC-1988
+rem OATES: Created: 16-Feb-83
+
+GRANT CONNECT,RESOURCE,UNLIMITED TABLESPACE TO SCOTT IDENTIFIED BY TIGER;
+ALTER USER SCOTT DEFAULT TABLESPACE USERS;
+ALTER USER SCOTT TEMPORARY TABLESPACE TEMP;
+CONNECT SCOTT/TIGER
+DROP TABLE DEPT;
+CREATE TABLE DEPT
+ (DEPTNO NUMBER(2) CONSTRAINT PK_DEPT PRIMARY KEY,
+DNAME VARCHAR2(14) ,
+LOC VARCHAR2(13) ) ;
+DROP TABLE EMP;
+CREATE TABLE EMP
+ (EMPNO NUMBER(4) CONSTRAINT PK_EMP PRIMARY KEY,
+ENAME VARCHAR2(10),
+JOB VARCHAR2(9),
+MGR NUMBER(4),
+HIREDATE DATE,
+SAL NUMBER(7,2),
+COMM NUMBER(7,2),
+DEPTNO NUMBER(2) CONSTRAINT FK_DEPTNO REFERENCES DEPT);
+INSERT INTO DEPT VALUES
+(10,'ACCOUNTING','NEW YORK');
+INSERT INTO DEPT VALUES (20,'RESEARCH','DALLAS');
+INSERT INTO DEPT VALUES
+(30,'SALES','CHICAGO');
+INSERT INTO DEPT VALUES
+(40,'OPERATIONS','BOSTON');
+INSERT INTO EMP VALUES
+(7369,'SMITH','CLERK',7902,to_date('17-12-1980','dd-mm-yyyy'),800,NULL,20);
+INSERT INTO EMP VALUES
+(7499,'ALLEN','SALESMAN',7698,to_date('20-2-1981','dd-mm-yyyy'),1600,300,30);
+INSERT INTO EMP VALUES
+(7521,'WARD','SALESMAN',7698,to_date('22-2-1981','dd-mm-yyyy'),1250,500,30);
+INSERT INTO EMP VALUES
+(7566,'JONES','MANAGER',7839,to_date('2-4-1981','dd-mm-yyyy'),2975,NULL,20);
+INSERT INTO EMP VALUES
+(7654,'MARTIN','SALESMAN',7698,to_date('28-9-1981','dd-mm-yyyy'),1250,1400,30);
+INSERT INTO EMP VALUES
+(7698,'BLAKE','MANAGER',7839,to_date('1-5-1981','dd-mm-yyyy'),2850,NULL,30);
+INSERT INTO EMP VALUES
+(7782,'CLARK','MANAGER',7839,to_date('9-6-1981','dd-mm-yyyy'),2450,NULL,10);
+INSERT INTO EMP VALUES
+(7788,'SCOTT','ANALYST',7566,to_date('13-JUL-87')-85,3000,NULL,20);
+INSERT INTO EMP VALUES
+(7839,'KING','PRESIDENT',NULL,to_date('17-11-1981','dd-mm-yyyy'),5000,NULL,10);
+INSERT INTO EMP VALUES
+(7844,'TURNER','SALESMAN',7698,to_date('8-9-1981','dd-mm-yyyy'),1500,0,30);
+INSERT INTO EMP VALUES
+(7876,'ADAMS','CLERK',7788,to_date('13-JUL-87')-51,1100,NULL,20);
+INSERT INTO EMP VALUES
+(7900,'JAMES','CLERK',7698,to_date('3-12-1981','dd-mm-yyyy'),950,NULL,30);
+INSERT INTO EMP VALUES
+(7902,'FORD','ANALYST',7566,to_date('3-12-1981','dd-mm-yyyy'),3000,NULL,20);
+INSERT INTO EMP VALUES
+(7934,'MILLER','CLERK',7782,to_date('23-1-1982','dd-mm-yyyy'),1300,NULL,10);
+DROP TABLE BONUS;
+CREATE TABLE BONUS
+(
+ENAME VARCHAR2(10)	,
+JOB VARCHAR2(9) ,
+SAL NUMBER,
+COMM NUMBER
+) ;
+DROP TABLE SALGRADE;
+CREATE TABLE SALGRADE
+ ( GRADE NUMBER,
+LOSAL NUMBER,
+HISAL NUMBER );
+INSERT INTO SALGRADE VALUES (1,700,1200);
+INSERT INTO SALGRADE VALUES (2,1201,1400);
+INSERT INTO SALGRADE VALUES (3,1401,2000);
+INSERT INTO SALGRADE VALUES (4,2001,3000);
+INSERT INTO SALGRADE VALUES (5,3001,9999);
+COMMIT;
+
+SET TERMOUT ON
+SET ECHO ON