Delphi in Depth: FireDAC, Copyright 2017 Cary Jensen ISBN: ISBN-10: , ISBN-13: ,

Transcription

1

2 Chapter Titles v Chapter Titles Chapter Titles... v Table of Contents... vii About the Author... xvii About the Technical Reviewers... xix Acknowledgements... xxi Introduction... 1 Chapter 1 Overview of FireDAC... 5 Chapter 2 Connecting to Data Chapter 3 Configuring FireDAC Chapter 4 Basic Data Access Chapter 5 More Data Access Chapter 6 Navigating and Editing Data Chapter 7 Creating Indexes Chapter 8 Searching Data Chapter 9 Filtering Data Chapter 10 Creating and Using Virtual Fields Chapter 11 Persisting Data Chapter 12 Understanding FDMemTables Chapter 13 More FDMemTables: Cloned Cursors and Nested DataSets Chapter 14 The SQL Command Preprocessor Chapter 15 Array DML Chapter 16 Using Cached Updates Chapter 17 Understanding Local SQL Appendix A Code Download, Database Preparation, and Errata Index

3 Table of Contents vii Table of Contents Dedication... 3 Chapter Titles... v Table of Contents... vii About the Author... xvii Cary Jensen... xvii About the Technical Reviewers... xix Dmitry Arefiev... xix Holger Flick... xix Jens Fudge... xx Bruce McGee... xx Acknowledgements... xxi Introduction... 1 Who Is This Book For... 2 Conventions... 2 Chapter 1 Overview of FireDAC... 5 FireDAC Features... 6 Cross-Platform Support... 7 Exceptional Support for Databases... 7 Flexible Queries Using the SQL Command Preprocessor... 8 Blazing Performance with Array DML... 8 Support for a Variety of Query Execution Modes... 9 Powerful Monitoring Capabilities... 9 Cached Updates Result Set Persistence Data Type Mapping Local SQL Additional Features Connection Recovery Advanced Transaction Support Built-In Dialog Support Support for Database-Specific Services Customizable Data Access Batch Move Support... 13

4 viii Delphi in Depth: FireDAC Written in Object Pascal Chapter 2 Connecting to Data Creating Unnamed Connections Creating Temporary Connections Defining a Temporary Connection Using FDConnection.Params Defining a Temporary Connection at Runtime Creating Named Connections Creating Named Connections Definition Using the Database Explorer Creating a Named Connection Definition Using the FireDAC Explorer Creating a Persistent Connection Creating a Private Connection Connecting to Any Database Using ODBC Chapter 3 Configuring FireDAC Share Configuration Properties Configuration Property Inheritance Overriding Individual Configuration Properties Restoring Configuration Property Inheritance Configuring the Shared Properties Fetch Options General Fetching Items to Fetch Items to Cache Master-Detail Live Data Window Format Options Data Mapping Rules Handling BCD/FmtBCD Type and DataSnap Compatibility Handling String Type Parameters Default Type Value Preprocessing Dataset Sorting Quotation Identifier Default Field Formats Resource Options Command Text Processing Persistence Mode Command Execution Connection Resources Update Options... 70

5 Table of Contents ix General Updating Locking Refreshing Automatic Incrementing Posting Changes Transaction Options Isolation Level Update Ability Automatic Committing DBMS-Specific Parameters Disconnection Action Nesting Understanding UpdateOptions.UpdateMode Chapter 4 Basic Data Access The User Interface and Data Binding Navigation and VCL Data Links The DBNavigator Multi-Record VCL Controls and Navigation: DBGrid and DBCtrlGrid Navigation and LiveBindings The BindNavigator Position-Related LiveBindings Understanding FDTable Configuring an FDTable Executing Datasets at Design Time Executing DataSets at Runtime When Should You Connect? Live Data Window Executing Queries and Stored Procedures Executing Queries Executing Stored Procedures Chapter 5 More Data Access Parameterized Queries and Stored Procedures The Advantages of Parameters Greater Flexibility Improved Performance Prevention of SQL Injection Defining Parameters at Design Time Parameterized FDQueries and the Query Editor

6 x Delphi in Depth: FireDAC Defining Parameters at Runtime Taking Control of Updates: FDUpdateSQL Defining the Query Configuring the DataSet Creating the Parameterized FDUpdateSQL Queries FDCommand, FDTableAdapter, and FDMemTable Managing Transactions Implicit and Explicit Transactions Transaction Isolation Dirty Read Isolation Read Committed Isolation Repeatable Read Isolation Nested Transactions Asynchronous Queries Monitoring FireDAC Queries Chapter 6 Navigating and Editing Data Understanding Fields The Current Record Detecting Changes to Record State Calculating Performance Navigating Programmatically Basic Navigation Have I Gone Too Far? Bof and Eof Using MoveBy Navigating Using RecNo Scanning a FireDAC DataSet Disabling Controls While Navigating Navigating Using Bookmarks Editing a DataSet Chapter 7 Creating Indexes Index Overview Temporary Indexes An Example of Creating Temporary Indexes at Runtime Temporary Indexes and FormatOptions.SortOptions Persistent Indexes Defining Persistent Indexes Creating Field-Based Indexes Creating a Field-Based Index at Design Time Selecting an Index at Design Time Creating a Field-Based Index at Runtime

7 Table of Contents xi Selecting an Index at Runtime Creating Expression Indexes Creating Distinct Indexes Creating a Filter-Based Index Two Runtime Index Examples: Sorting a DBGrid On-The-Fly Chapter 8 Searching Data Searching FireDAC DataSets Simple Record-by-Record Searches Searching with Indexes Finding Data Going to Data Searching with Variants Locating Data Using Lookup Chapter 9 Filtering Data Filters Using a Range Setting Ranges Using ApplyRange Canceling a Range A Comment About Ranges Using Filters Basic Filters Special Filter Expressions Null Comparisons String Functions Date/Time Functions Miscellaneous Functions Escaping Wildcard Characters FireDAC Scalar Functions Other Filter-Related Properties Using the OnFilterRecord Event Handler Navigating Using a Filter Using Ranges and Filters Together Master-Detail Views: Dynamically Filtered Detail Tables Defining a Range-Based Dynamic Master-Detail Relationship Defining a Parameter-Based Dynamic Master-Detail Relationship Detail Records and the FetchOptions.DetailDelay Property

8 xii Delphi in Depth: FireDAC Chapter 10 Creating and Using Virtual Fields Aggregate Fields Creating Aggregate Fields Adding the Aggregate Field Defining the Aggregate Expression Setting Aggregate Index and Grouping Level Making the Aggregate Field Available Turning Aggregates On and Off Creating Aggregate Collection Items Understanding Group State Creating AggregateFields at Runtime Calculated Fields InternalCalc Fields and FireDAC Scalar Functions Lookup Fields Understanding FieldOptions The FieldOptions Property Combine Options and PositionMode The UpdatePersistent FieldOptions Property Field and Fields Properties Chapter 11 Persisting Data Persisting Data to Files Saving to Files File formats Storing Human-Readable Data What to persist Persisted Version Information Loading from Files File Formats Merging Data When Loading Automating Persistence Maintaining Backups Persisting to Streams Saving to a Stream Loading from a Stream Persistence and FDSchemaAdapters Chapter 12 Understanding FDMemTables The Role of FDMemTable in FireDAC Applications Defining an FDMemTable's Structure

9 Table of Contents xiii Defining Structure Using FieldDefs Creating FieldDefs at Design Time Creating FieldDefs at Runtime Defining an FDMemTable's Structure Using Fields Creating Fields at Design Time Creating Fields at Runtime Loading FDMemTables Directly From DataSets Loading an FDMemTable Using CopyDataSet Other FDDataSets and CopyDataSet Copying Data Using the FDDataSet Data Property Editing Data at Design Time Chapter 13 More FDMemTables: Cloned Cursors and Nested DataSets Cloning and FDMemTables Master with Detail Clone Editing with Cloned Cursors and Cached Updates Creating Nested DataSets Defining Nested DataSets at Design Time Defining Nested DataSets at Runtime Using FieldDefs at Runtime Using Fields at Runtime Final Thoughts About Nested DataSets Chapter 14 The SQL Command Preprocessor Macro Substitution Escape Sequences Constant Substitution Identifier Substitution Conditional Substitution FireDAC Scalar Functions FireDAC String/Character Scalar Functions Numeric Scalar Functions Date/Time Scalar Functions System Scalar Functions The Convert Scalar Function Special Character Processing Chapter 15 Array DML Using Array DML Array DML Mode and Errors

10 xiv Delphi in Depth: FireDAC Handling Array DML Limits Chapter 16 Using Cached Updates Cached Updates: The Basics Entering and Exiting Cached Updates Detecting the Cache State Record Status and Change Filters What Has Changed? Persisting the Cache Managing the Cache Canceling the Last Change Canceling a Specific Change Canceling All Updates Clearing the Cache Without Canceling Changes Using Save Points Applying Updates Apply Updates Using Brute Force Calling the ApplyUpdates Method The ApplyUpdates Method in Automatic Mode ApplyUpdates and OnUpdateRecord ApplyUpdates and Errors Managing Errors Following the Call to ApplyUpdates Managing Errors Using Event Handlers Understanding Centralized Cached Updates Managing Master-Detail Tables in the Centralized Cached Updates Model Chapter 17 Understanding Local SQL Implementing Local SQL The Initial Setup Configuring the SQLite Connection Configuring the Datasets Configuring FDLocalSQL Activating Local SQL Queries at Runtime Some Comments on FDLocalSQL Appendix A Code Download, Database Preparation, and Errata Code Download Database Preparation Installation The DataPaths Unit Using SharedDMVcl The EMPLOYEE Named Connection

11 Table of Contents xv InterBase UDF Definitions Errata Index

12