• 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_ImportTablesDialog 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_Lookup Function

Syntax

Arguments

connCharacter SQL::Connection

An explicit AlphaDAO connection string, or a named connection string. E.g. ::name::myconnectionstring, or a pointer to an open SQL::Connection object.

tableCharacter

The name of the table in the remote database in which to perform the lookup.

filterCharacter

A filter expression to determine which record in the remote table to find. The filter expression must use SQL syntax and must use portable AlphaDAO functions. For example, strings must be single quoted, the AND, OR and NOT operators are not surrounded by periods. The filter expression can use arguments. For example, customerid = :whatcustomerid. The function will accept a blank filter expression and return all values. If the "result_Expression" in the function is a comma delimited list of fields, then the function returns all fields listed in "result_Expression" for the first record found when "flagReturnAllValues" is false.

result_ExpressionCharacter

A expression to determine what value gets returned. The expression can be as simple as a single column name in the remote table, or it can be a complex expression. The expression must be written using portable AlphaDAO syntax.

argsSQL::Arguments

If the filter expression includes arguments, you must supply argument values using a SQL::arguments object.

flagReturnAllValuesLogical

A flag that indicate whether or not all values should be returned. Returns one record if false, otherwise all records are returned.

ColumnSeparatorCharacter

Default = tab. The character used to separate columns. The column separator is only used if the result expression is a comma delimited field list.

Returns

valueAny Type Character

Value returned by the function. Can be of any type, depending on the value that result_expression evaluates to. Returns a null value if no matching value was found. If a filter is defined and a single field is specified in the return expression, the return value is typed appropriately. If more than one value is returned, or no filter is specified, the return value is a character string.

Description

Does a lookup into a table in a remote database using AlphaDAO. Returns a field value or expression from the remote table. Connection can be explicit, or a named connection (e.g. ::name::myconnection).

Example

dim connection as c = "::Name::Northwind"
dim table as c = "customers"
dim result_expression as c = "concatenate(city,' - ',contactname)"
dim filter as c = "customerid = :whatcustomerid"
dim args as sql::arguments
args.set("whatcustomerid","BOLID") 

result = sql_lookup(connection,table,filter,result_expression,args)

if (typeof(result) != "Z") then
    ' Record found
    showvar(result)
else
    ' NULL value
    showvar("No Match")
end if

See Also

• sql_insert Function
• sql_update Function
• sql_lookup_multi Function