Enables or disables unicode encode mode.
In this mode, if the server supports UTF-8 and the connection
charset is latin1
(the default) or unicode
then
big_query handles wide unicode queries. Enabled by default.
Unicode encode mode works as follows: Eight bit strings are sent
as latin1
and wide strings are sent using utf8
.
big_query sends SET character_set_client
statements as
necessary to update the charset on the server side. If the server
doesn't support that then it fails, but the wide string query
would fail anyway.
To make this transparent, string literals with introducers (e.g.
_binary 'foo'
) are excluded from the UTF-8 encoding. This
means that big_query needs to do some superficial parsing of
the query when it is a wide string.