Skip to main content

Update records

Updates the value of records by selected criteria

Function UpdateRecords(Val Table, Val ValueStructure, Val Filters = "", Val Connection = "", Val Tls = "") Export

ParameterCLI optionTypeRequiredDescription
Table--tableStringTable name
ValueStructure--valuesStructure Of KeyAndValueValues structure: Key > field, Value > field value
Filters--filterArray of StructureFilters array. See GetRecordsFilterStrucutre
Connection--dbcString, ArbitraryConnection or connection string
Tls--tlsStructure Of KeyAndValueTLS settings, if necessary. See GetTlsSettings

Returns: Map Of KeyAndValue - Result of query execution


tip

Record data is specified as an array of structures of the following type:
{'Field name 1': {'Type': 'Value'}, 'Field name 2': {'Type': 'Value'},...}

The list of available types is described on the initial page of the MySQL library documentation


1C:Enterprise/OneScript code example
    Address  = "127.0.0.1";
Login = "bayselonarrend";
Password = "12we...";
Base = "test_data";

TLS = True;
Port = 3306;
ConnectionString = OPI_MySQL.GenerateConnectionString(Address, Base, Login, Password, Port);

If TLS Then
TLSSettings = OPI_MySQL.GetTLSSettings(True);
Else
TLSSettings = Undefined;
EndIf;

Table = "test_data";

FieldsStructure = New Structure;
FieldsStructure.Insert("ip_address", New Structure("VARCHAR", "127.0.0.1"));

Filters = New Array;

FilterStructure = New Structure;

FilterStructure.Insert("field", "gender");
FilterStructure.Insert("type" , "=");
FilterStructure.Insert("value", New Structure("VARCHAR", "Male"));
FilterStructure.Insert("raw" , False);

Filters.Add(FilterStructure);

// When using the connection string, a new connection is initialised,
// which will be closed after the function is executed.
// If several operations are performed, it is desirable to use one connection,
// previously created by the CreateConnection function()
Result = OPI_MySQL.UpdateRecords(Table, FieldsStructure, FilterStructure, ConnectionString, TLSSettings);
    oint mysql UpdateRecords \
--table ""test_data"" \
--values ""/tmp/nyzrddm4.ynv.json"" \
--filter ""/tmp/ozrtwfjk.40y.json"" \
--dbc "mysql://bayselonarrend:***@127.0.0.1:3306/" \
--tls ""/tmp/qeqw4r1h.hps.json""
Result
{
"result": true
}