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