• SQL Events
• *like Function
• *sql_where Function
• a5_ADO_ResolveConnectionString Function
• a5_alphadao_export Function
• a5_alphadao_import Function
• a5_alphadao_search Function
• a5_alphadaoexportgenie Function
• a5_alphadaoimportgenie Function
• a5_arguments_sqllist Function
• A5_BatchPassiveLinkCreate Function
• a5_changealias_insql Function
• a5_complete_import_task Function
• a5_connectionpropstostring Function
• A5_CONNECTIONSTRING Function
• a5_connstrings_list Function
• a5_convert_delete_to_sql_delete Function
• a5_convert_deletedups_to_sql Function
• a5_convert_update_to_sql_update Function
• A5_CreateLayoutFromDataSource Function
• A5_CreatePassiveLinkTable Function
• a5_createsql_layout Function
• a5_createtable_sql_import Function
• a5_csweb_syntaxnamefromado Function
• a5_databaseexplorer Function
• a5_defineconnectionstring Function
• A5_ExcelConnString Function
• a5_exportconnectionstrings Function
• a5_getalphasqlfunction Function
• a5_getnamedconnectionstring Function
• a5_getnamedsqldatasource Function
• a5_getprimarykeysfromdaosearchresult Function
• a5_getreportsqlfilter Function
• a5_getreportsqlorder Function
• a5_getsavedadoconn_string Function
• a5_importconnectionstrings Function
• a5_invertsqlorder Function
• a5_list_tables_with_types Function
• a5_lookupsavedconnectionstring Function
• A5_MDBConString Function
• a5_mergeDataIntoTemplate Function
• a5_mergesqlarguments Function
• a5_namedconnectioncreate Function
• a5_odbc_connection Function
• a5_odbc_import_genie Function
• a5_paradoxconnstring Function
• A5_PassiveLinkTableDefine Function
• a5_preview_datasource Function
• A5_RefreshPassiveLinkTable Function
• A5_RefreshPassiveLinkTableDialog Function
• a5_sql_addcolumnstoselect Function
• a5_sql_addfilterorder Function
• a5_sql_arguments_dump Function
• a5_sql_arguments_load Function
• A5_SQL_BatchImportTables Function
• a5_sql_builder_simple Function
• a5_sql_cache_datafilename Function
• a5_sql_commandwindow Function
• a5_sql_droptables Function
• a5_sql_extractorder Function
• a5_sql_generate_select2 Function
• A5_SQL_ImportDataSource Function
• a5_sql_parsewhereclause Function
• a5_sql_parsewhereclause_datatypes Function
• a5_sql_query_genie Function
• A5_SQL_QuerySaveAs Function
• a5_sql_record_content_get Function
• a5_sql_record_xbase_content_get Function
• a5_sql_removeorder Function
• a5_sql_table_selector Function
• a5_sqlconnectionstring_unhidepassword Function
• a5_sqlexpressionbuilder Function
• a5_sqlimport_execute Function
• A5_SQLResultSetPreview Function
• a5_sqlToJSONExpandingMenu Function
• a5cs_decomposeaggregateexpression Function
• a5cs_generatenativefilter Function
• a5cs_generatenativeorder Function
• a5cs_getfunctionsinsqlexpression Function
• a5cs_getprimarykeycolumns Function
• a5cs_sql_add_filter_order Function
• a5cs_validateexpression Function
• a5gridhelper_dumpargumentstohtml Function
• a5Helper_findRecordInSQLTable Function
• a5SQLConnectionOpen Function
• a5wcb_exportstaticdatatosql Function
• argval Function
• cn_open Function
• combine_sql_arguments Function
• create_table_sql Function
• DataTransformExpression Example
• Portability Functions
• replace_arguments_in_string Function
• replace_placeholders_with_argument_values Function
• showresultset Function
• sql_argumentsdialog Function
• sql_avg Function
• sql_cacheapplyupdates Function
• sql_cacheevents Function
• sql_cachefetchpage Function
• sql_cachefetchpageeventscript Function
• sql_cacheopen Function
• sql_cacherefresh Function
• sql_cacherefreshinsertedrow Function
• sql_cacherefreshrow Function
• sql_childrelationsadded Function
• sql_childrelationsclear Function
• sql_childrelationspopulate Function
• SQL_ConnectionStringDialog Function
• SQL_ConnectString Function
• sql_count Function
• SQL_DatabaseExportDialog Function
• SQL_DATE Function
• sql_delete Function
• Sql_get_Values Function
• sql_import Function
• sql_insert Function
• SQL_InstallOracleLiteFunctions Function
• sql_linkcreate Function
• sql_listoptionsdialog Function
• SQL_Lookup Function
• SQL_lookup_multi Function
• sql_max Function
• sql_min Function
• sql_namedinstanceget Function
• sql_nameinstancegetsimple Function
• sql_primarykeydialog Function
• sql_query Function
• SQL_QUERY_BUILDER Function
• SQL_QueryImport Function
• sql_queryrenamewhereclausearrayoperators2 Function
• sql_quote Function
• SQL_Records_Get Function
• SQL_ResultSet_Preview Function
• sql_safeexecute Function
• sql_sum Function
• SQL_TableExport Function
• SQL_TableExportDialog Function
• SQL_TableImport Function
• SQL_TableImportDialog Function
• SQL_TableInfoOfDBF Function
• sql_tableinfotodbf Function
• SQL_TableInfoToOpenTable Function
• sql_tableinfotostring Function
• sql_time Function
• sql_update Function
• sql_upsert Function
• SYS_REMOVE Function

sql_update Function

Syntax

Arguments

connectionCharacter SQL::Connection

An open SQL::connection object, a connection string, or a named connection string.

tablenameCharacter

Name of the table to update.

fieldValuePairsCharacter

Fields to update with corresponding values. A cr-lf list of the form fieldname=value. Or a JSON string (see example). Date values must be specified using yyyy/mm/dd format.

primaryKeyCharacter

Name of primary key field. If primaryKey is multi column use ||| to delimit (e.g. OrderNumber|||PartNumber)

primaryKeyValueCharacter

Value of primary key. If primaryKey is multi-column, use ||| to delimit (e.g. 10245|||23)

executeLogical

If false, the SQL is not executed. However, you can still examine the result.sql and result.arguments properties to see what SQL was generated.

Returns

resultPointer

An object with the following properties:

errorLogical

If .t., an error occurred. Otherwise .f..

errorTextCharacter

A detailed description of the error - if any occurred.

sqlCharacter

The SQL that was generated to execute the update.

ArgumentsCharacter

The XML arguments generated for the update.

Description

Updates a record in a SQL table.

Discussion

This function is just a wrapper around the Xbasic AlphaDAO commands to execute a SQL update statement, but it convenient to use for simple cases.

dim cn as sql::Connection

cn.open("::Name::myconnstring")
tablename = "mytable"
fieldsValuePairs = <<%str%
name=fred smith

date of birth=1952/12/18

salary=78000
%str%
 

'You can also specify field values using JSON
fieldsValuePairs = <<%str%
{
    "name" : "fred smith",
    "date of birth" : "1954/11/25",

    "salary" : "78000"
}
%str%

primaryKey = "id"
primarykeyValue = "1"

p = sql_update(cn,tablename,fieldsValuePairs,primaryKey,primaryKeyvalue)

See Also

• sql_lookup Function
• sql_insert Function