<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept xml:lang="en" id="GUID-22844C28-AB5B-5A6F-8863-7269464684B4"><title>Symbian SQL Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>This document introduces you to the Symbian OS implementation of the Structured Query Language(SQL). </p> <section><title>Purpose</title> <p>SQL is: the syntax for creating, modifying and deleting databases and the data they contain; an engine or server that understands that syntax; the commands and operations that allow the SQL engine to process the syntatical elements. Developers who know one varient of SQL can easily work in another. </p> </section> <section><title>Required background</title> <p>Relational databases, the SQL query language, database programming fundamentals. </p> </section> <section><title>Key concepts/terms</title> <p>The SQL component includes these key concepts: </p> <ul><li id="GUID-BA38B572-000A-5798-B10E-0E54FB5300DC"><p>Relational database </p> <p>A structured collection of data organised as tables (relations). </p> </li> <li id="GUID-37E36881-7760-5269-B11A-128C81FE5741"><p>SQL </p> <p>A standard language for querying relational databases. </p> </li> <li id="GUID-AFC25A9E-C040-548A-9C62-C8D03C5F1055"><p>Security policy </p> <p>A specification of user permissions on a database. </p> </li> </ul> </section> <section><title>Architectural relationships</title> <p>The SQL component is a free standing component that can be accessed by any application and from anywhere in Symbian OS. </p> <p>It is has a client-server architecture. Applications interface with the client API. The server side is an executable running in its own process and is not directly accessible to client applications. It can only be reached via the client-side interface. </p> <fig id="GUID-79734111-15D9-51E2-A1CE-09A4F72D1B21"><title>

             This image depicts the client / server nature of Symbian SQL 

          </title> <image href="GUID-A6EE8A2A-8B17-5D3A-A9B9-C8D25C92EA21_d0e577045_href.png" placement="inline"/></fig> </section> <section><title>API summary</title> <p>The SQL component client consists of three APIs which are used to access, query and secure a database. </p> <p><b>SQL APIs </b> </p> <ul><li id="GUID-74A5E9C2-A9CA-5595-8249-E311054EBFE6"><p>The SQL database API, which you use to access a database. </p> </li> <li id="GUID-4FE61907-6DBA-5B59-B923-F2AB623BE3B2"><p>The SQL statement API, which you use to query a database. </p> </li> <li id="GUID-1530DA5D-3E75-5C71-9AA9-72EA342AF3E6"><p>The SQL security policy API, which you use to create a secure database. </p> </li> </ul> <table id="GUID-89A08BF1-F7CB-594A-9693-42CB5AE4B499"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry>API</entry> <entry>Description</entry> </row> </thead> <tbody><row><entry><p> <xref href="GUID-4688F6B7-E1B0-37CF-BAA2-C6BD103D4FDF.dita"><apiname>RSqlDatabase</apiname></xref>  </p> </entry> <entry><p>The SQL database API </p> </entry> </row> <row><entry><p> <xref href="GUID-0176BF07-DF94-3259-8F90-DE030E35CE9A.dita"><apiname>RSqlStatement</apiname></xref>  </p> </entry> <entry><p>The SQL statement API </p> </entry> </row> <row><entry><p> <xref href="GUID-56C52D43-C4A9-3B31-B154-CA1E77693F57.dita"><apiname>RSqlSecurityPolicy</apiname></xref>  </p> </entry> <entry><p>The SQL security policy API </p> </entry> </row> </tbody> </tgroup> </table> </section> <section><title>Typical uses</title> <p>Relational databases and the SQL query language are fundamentals of application development with numerous uses. </p> <p><b>SQL Users </b> </p> <ul><li id="GUID-747924C7-5E24-5EA5-9E11-8FB216822A0B"><p>Application developers needing to access databases. </p> </li> </ul> <p><b>SQL tasks</b> </p> <p>The SQL component is used to: </p> <ul><li id="GUID-79CD646D-0E08-5F17-ADDF-D245D0CEEF74"><p>create, </p> </li> <li id="GUID-98666D77-DA2F-58B5-BEAB-3FFC149425EE"><p>delete, </p> </li> <li id="GUID-D7D164C6-FF45-5A2B-AB3F-B011F04BCF3F"><p>access, </p> </li> <li id="GUID-012D297E-74B7-5B53-98C8-8ECF97C16141"><p>query, and </p> </li> <li id="GUID-8CCECFDE-1D8E-5A66-A1CE-DBEB5777EC76"><p>modify relational databases. </p> </li> </ul> <p><b>Creating and deleting a relational database</b> </p> <p>The SQL component is used to create and delete relational databases. They may be secure or insecure. </p> <p><b>Accessing a relational database</b> </p> <p>Use the SQL component to open and close databases and to attach a secondary database to a primary one. </p> <p><b>Querying and modifying a relational database</b> </p> <p>Use the SQL component to query a database using SQL. Queries can read, write, modify and delete data in a database. </p> </section> </conbody><related-links><link href="GUID-22844C28-AB5B-5A6F-8863-7269464684B4.dita"><linktext>SQL Overview</linktext> </link> <link href="GUID-1F12E3F5-45B2-55EC-B021-00338277C608.dita"><linktext>SQL DB Overview</linktext> </link> <link href="GUID-78773BCA-ADF6-53E6-AC80-5CB2AE1F8BCC.dita"><linktext>SQL Server Guide</linktext> </link> <link href="GUID-F8824165-4B33-50D1-9706-BD2438B5A2EE.dita"><linktext>Persistent Storage</linktext> </link> </related-links></concept>