Pervasive.SQL 2000i Pervasive.SQL User’s Guide Guide to Using Pervasive.SQL Pervasive Software, Inc. 12365 Riata Trace Parkway Building II Austin, TX 78727 USA Telephone: +1 512 231 6000 or 800 287 4383 Fax: +1 512 231 6010 E-Mail: [email protected] Web: http://www.pervasive.com disclaimer PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND DOCUMENTATION PRODUCT TO YOU OR YOUR COMPANY SOLELY ON AN “AS IS” BASIS AND SOLELY IN ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE ACCOMPANYING LICENSE AGREEMENT. PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING THE SOFTWARE OR THE CONTENT OF THE DOCUMENTATION; PERVASIVE SOFTWARE INC. HEREBY EXPRESSLY STATES AND YOU OR YOUR COMPANY ACKNOWLEDGES THAT PERVASIVE SOFTWARE INC. DOES NOT MAKE ANY WARRANTIES, INCLUDING, FOR EXAMPLE, WITH RESPECT TO MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE OR ARISING FROM COURSE OF DEALING OR USAGE OF TRADE, AMONG OTHERS. trademarks Btrieve, Tango, Client/Server in a Box, and the Pervasive Software logo are registered trademarks of Pervasive Software Inc. Built on Pervasive, Built on Pervasive Software, Extranet in a Box, Pervasive.SQL, Jtrieve, Plug n’ Play Databases, SmartScout, Solution Network, Ultra-light Z-DBA, Z-DBA, ZDBA, UltraLight, MicroKernel Database Engine, and MicroKernel Database Architecture are trademarks of Pervasive Software Inc. Microsoft, MS-DOS, Windows, Windows NT, Win32, Win32s, and Visual Basic are registered trademarks of Microsoft Corporation. Windows 95 is a trademark of Microsoft Corporation. NetWare and Novell are registered trademarks of Novell, Inc. NetWare Loadable Module, NLM, Novell DOS, Transaction Tracking System, and TTS are trademarks of Novell, Inc. All other company and product names are the trademarks or registered trademarks of their respective companies. Copyright 2001 Pervasive Software Inc. All rights reserved. Reproduction, photocopying, or transmittal of this publication, or portions of this publication, is prohibited without the express prior written consent of the publisher. This product includes software developed by Powerdog Industries. Copyright 1994 Powerdog Industries. All rights reserved. The ODBC Driver Manager for NetWare (ODBC.NLM) included in this product is based on the GNU iODBC software Copyright 1995 by Ke Jin <[email protected]> and was modified by Simba Technologies Inc. in June 1999. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. A copy of the GNU Lesser General Public License is included in your installation of Pervasive.SQL 2000i at \pvsw\doc\lesser.htm. If you cannot find this license, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111- 1307 USA. You may contact Pervasive Software Inc. using the contact information on the back cover of this manual. Pervasive.SQL User’s Guide March 2001 100-003672-004 Contents Contents About This Manual . ix Who Should Read This Manual . x Manual Organization . xi Conventions . xii 1 Introducing Pervasive.SQL . 1-1 Understanding Pervasive.SQL and its Capabilities Understanding Pervasive.SQL . 1-2 What is a Database? . 1-2 What is a Database Management System? . 1-3 Components of Pervasive.SQL . 1-3 Key Concepts . 1-5 Basic Database Structures and Terms . 1-5 Unique Benefits of Pervasive.SQL . 1-8 Why Pervasive.SQL? . 1-10 Understanding the Product Family . 1-12 Workstation . 1-12 Workgroup . 1-13 Server . 1-13 Replication . 1-14 Crystal Reports for Pervasive.SQL . 1-15 Helpful Utilities . 1-16 Using Pervasive.SQL Documentation . 1-18 Getting Started Guides. 1-18 User’s Guide . 1-19 Advanced Operations Guide . 1-19 SQL Engine Reference . 1-19 Status Codes and Messages . 1-19 Pervasive Products and Services . 1-20 Online Help. 1-20 File System Security. 1-21 2 Using Pervasive.SQL . 2-1 A Walk-through of Basic User Tasks Starting and Stopping the Database Engine. 2-2 Starting and Stopping Services on Windows Server . 2-3 Starting and Stopping Services on NetWare . 2-4 Starting and Stopping Services on Unix . 2-5 Granting Administrative Rights for the Database Engine . 2-6 Tasks Requiring Administrative Rights. 2-6 iii Contents How Administrative Rights are Granted . 2-6 Rights Provided to Normal Users . 2-6 Granting Administrative Rights on Windows Server. 2-9 Granting Administrative Rights on NetWare 3.2 . 2-11 Granting Administrator Rights on NetWare 4.2 or 5.0 . 2-11 Granting Administrator Rights on Unix . 2-12 Logging in as Administrator . 2-13 Setting Up ODBC Database Access . 2-14 Basic Concepts. 2-14 What to Know if You are Recreating DSNs . 2-17 Prerequisites to Setting up Database Access. 2-17 Setting Up Database Access on a Windows Server or Workgroup/Workstation . 2-19 Setting Up Database Access on a NetWare Server . 2-28 Setting Up Database Access on Unix . 2-36 Setting Up Client Access. 2-39 Accessing Data via ODBC From Other Applications . 2-46 Before You Begin . 2-46 Accessing Data Using Microsoft Excel. 2-46 Accessing Data Using Microsoft Access . 2-49 Deleting DSNs . 2-53 Bound Databases and Enforced Integrity . 2-56 3 Using the Pervasive Control Center . 3-1 A Brief Tour of Pervasive Control Center An Overview of Pervasive Control Center . 3-2 Registering or Removing a Server. 3-4 Viewing Database Engines. 3-7 Interpreting Server Status Icons . 3-7 Pervasive Control Center Wizards . 3-9 Adding or Creating a Database . 3-11 Deleting a Database . 3-15 Adding a Table . 3-18 Modifying a Table Definition . 3-25 Dropping a Table. 3-29 Setting Database Security . 3-31 Turning Security On and Off. 3-31 Working with Groups and Users. 3-32 Stopping and Restarting Services on Windows Servers . 3-38 Viewing and Modifying Table Properties . 3-39 Viewing and Modifying Data . 3-42 Viewing Data . 3-42 Writing and Executing SQL Statements . 3-42 Using the SQL Statement Builder . 3-45 Exporting/Importing Data . 3-46 Checking Consistency and Referential Integrity . 3-54 iv Contents Listing Referential Constraints . 3-54 Checking Consistency . 3-55 Checking Referential Integrity . 3-57 4 Unix Supplementary Documentation . 4-1 Additional Information on Unix Utilities User Manual Exclusions for Unix . 4-2 Utilities . 4-2 Changes and Exclusions . 4-2 Man Pages . 4-4 Available Utilities . 4-5 5 Basic Troubleshooting . 5-1 How to Identify and Solve Common Problems General Troubleshooting. 5-2 Error Messages from PCC . ..