Update records

Updates the value of records by selected criteria

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

Parameter	CLI option	Type	Required	Description
Table	--table	String	✔	Table name
ValueStructure	--values	Structure Of KeyAndValue	✔	Values structure: Key > field, Value > field value
Filters	--filter	Array of Structure	✖	Filters array. See GetRecordsFilterStrucutre
Connection	--dbc	String, Arbitrary	✖	Connection or connection string
Tls	--tls	Structure Of KeyAndValue	✖	TLS 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);

Bash

    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""

CMD/Bat

    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
}