Useful. Mighty useful.
Thought I’d share
http://www.microsoft.com/en-us/download/details.aspx?id=39083
http://www.microsoft.com/en-us/download/details.aspx?id=722
http://www.microsoft.com/en-us/download/details.aspx?id=9301
http://www.microsoft.com/en-us/download/details.aspx?id=14606
SQL Azure, sorry I mean Windows Azure … sorry, Microsoft Azure SQL Database is an interesting database platform. Connections to it have to be made per database meaning the more traditional connections made to a SQL Instance don’t work quite the same. Add to that a sharded dataset spanning multiple SQL Databases and you’re into the realm of “tricky queries”. Even a simple query can be quite challenging if when you don’t have the right tools available. Take for example a request for the number of users by country – it may look something like this:
select countrycode, count(*)
from dbo.myusers
group by countrycode;
Oooooh, but hang on. You have your users sharded across 100 databases, each one requiring a discrete connection. We have to run a fan-out query hitting all 100 databases, gather the results, then apply a second aggregation on the result set to get the answer we want.
Some time ago in my early days of SQL Database, it became clear very quickly that a tool was needed to run fan-out queries and return a single merged result set. I had started learning Powershell so played around with it for a while, but in truth an application was needed with a nice(ish) interface to use. A developer colleague of mine knocked together such a tool allowing me to import a configuration file, i.e. a list of database connections, and run TSQL against those I selected from a treeview, using the SqlCommand C# library. It was great! I could specify the number of threads to use to maximise performance, and get a consolidated set of data returned. Even better, I could copy and paste the data into Excel to perform further analysis or aggregation when required. It was something I used for a very long time until just recently…
Another colleague of mine, Antonio Vlachopoulos (Linkedin), mentioned he was using Registered Servers and it was much quicker. It intrigued me. I’ve been aware of the feature for years but never tried it for SQL Database. It stemmed back to when I first needed to run those fan-out queries, and the thought of setting up each individual database connection put me off as we had hundreds.
I’ve happily used my fan-out query app for years, without ever having the need to change to something else. But in the interest of finding “the best way” I thought I’d try it out. And today things are different. Today I know Powershell. With Powershell I don’t have to manually create every Registered Server connection to my databases. Instead I can use my configuration database to generate the connections and create them automatically.
Below is a portion of the Powershell I used. You need to write a process to import your database connections somehow, whether it’s from a config file, or a database etc. After that the code will go off and create your Registered Server entries. It does assume it’s running on the local instance and that you have the appropriate permissions, so you may need to do a little experimentation for your environment.
So, onto the testing. I created my Registered Servers and decided to run something simple, but with enough records returned to make it a good test. In steps my original query at the start of this post:
select countrycode, count(*)For me, I was pulling back 100+ records each from about 400 databases. My fan-out query app went off and pulled the data back in around 17 seconds. Not bad for hitting that many databases in the cloud and getting the results collated, I thought. I ran it again, to allow for cached results. The time was about the same. Now for the turn of my Registered Servers – 4 seconds! If it was going to be quicker, I expected it to be marginal - but this was 4 times quicker. Remarkable. It was very important for me at that point to test out the speeds over both large and small datasets.
Large(r) Dataset
I started by taking 800kb of data from each of my 400 databases. This was done by generating 8000 bytes of nonsense data over 100 rows:
Surprisingly, the Registered Servers query came in slower. 29s compared to 13s for the fan-out query app. Tweaking the size of the binary data, I plotted out a number of timings for both the Registered Servers (RS) queries and fan-out query app (FQA).
You can quickly see that around 50MB the Registered Servers query hits a saturation point and slows badly. The fan-out query app stays fairly steady regardless of the size of the dataset being returned.
Explanation
The reason my test query contained a ‘runtime’ field was to allow me to see when the data was returned by each database. By comparing the earliest time against the latest across the complete set, we can get a feel for how long it took each method to execute the queries across all of the databases. The chart below shows the comparison.
It seems that with Registered Servers the queries are all executed as quickly as possible, which suggests a high number of threads in use (perhaps even one thread per target). With the fan-out query app, I control the number of threads in the config – for these tests I was using 32 threads. Having a staggered approach to returning the data, rather than everything coming back at once, can be beneficial for larger datasets. Any SSIS developers out there know all too well that trying to do too much at once ends up with much slower results. That certainly seems to be the case here – Registered Servers try to do too much. As soon as the result set grows too large for the local instance to handle efficiently, the process slows down considerably.
Conclusion
Registered Servers provide a brilliant mechanism for running lightweight queries against SQL Databases (and on-premises ones too for that matter). It is super fast as long as the result sets aren’t too large, but you’ll have to test out the thresholds for yourself as they’ll differ for every environment. The best part about it? It’s provided out-of-the-box with SQL Server.
The downside is the lack of granular control, in terms of threads etc. Also, when it comes to SQL Database my fan-out query app has a distinct advantage that it includes retry logic, a beneficial aspect when running queries in the cloud.
But for general ad hoc querying, Registered Servers will be my first choice from now on. Only when I need larger datasets will I switch back to the fan-out query app, but I suspect that will be a rarity.
It surprises me somewhat just how little is known about text encoding and code pages, by those professionals working with data every day. The fundamentals should be known by every data professional, so this post is intended to cover just that.
Firstly, I know that as an intelligent reader and data professional you know that characters exist in the presentation layer only. Kind of – the glyphs at least. They still exist as a sequence of bits, but depending on the encoding used they can be interpreted in many different ways. It’s up to the client reading the data to know what text encoding is being used so the correct characters can be displayed to the user. Why reiterate this? Well, it’s fundamental to understanding text encoding.
For example, let’s say I encode my alphabet as A=0, B=1, C=2 and so on. I send you the message “SQLTUNA” which would be passed over the wire as 18 16 11 19 20 13 0. Now let’s say you’re using the coding system of A=1, B=2, C=3 and so forth. When you display the message it would come out as “RPKSTM?” where the final character (?) is unknown. I don’t want to be known as RPKSTM?, so for that reason alone it’s important to have a standard encoding system that both parties are aware of.
Good news! We have standards. Lots of them. Without going into too much history, some time in the 1960s the American Standard Code for Information Interchange shortened their name and the ASCII standard was borne. OK, so there may have been a bit of intelligence and thought applied in between, but that’s just semantics.
ASCII maps the main Latin characters to the numbers 0 to 127. Lower and upper case letters, numbers and common punctuation, as well as some non-printable control characters such as the carriage return and tab (numbers 0-31 are reserved for control characters). It all fits neatly into 7 bits. And that’s where the problems started. Once it became commonplace to transfer data in 8-bit sequences, a.k.a. bytes, there was suddenly a “spare” bit opening up another 128 possible characters.
To cut a long story short, the “spare” or “extended” characters were used differently by different entities, mainly desktop providers such as IBM. The printable character set of 32-127 were kept as standard by pretty much everybody, however the extended set for 127-255 were used in different ways, and in some cases the control character range of 0-31 were changed.
Thus code pages came into existence. Allocating a code page to a particular set of characters allowed these encodings to be exchanged and mapped correctly by the recipient. So for example, if you received codes from someone and they told you it was encoded using code page 437 (IBM’s original code page) you would decode it to produce the output below:
Received:
201 205 187 13 200 205 188
Displayed:
╔═╗
╚═╝
“A Pretty Box”
However, if you mistakenly used the wrong code page to decode it, such as the Windows 1252 code page, you would end up with the following instead:
ÉÍ»
Èͼ
“A fraction better than Old Macdonald…”
You get the point. Many code pages have now been made official to describe the various different mappings of characters to codes. They all share the consistency of codes 32-127 from the ASCII standard, but beyond that you need to know the code page you’re dealing with in order to display the text correctly.
What happens if you need more than 256 characters in a set? Some languages such as Japanese have over a thousand characters. That simply ain’t gonna fit into 1 byte. So in stepped Unicode to rescue the situation. Devised around the late 1980s/early 90s, in conjunction with the Universal Character Set (an ISO standard), the intention was to create a mapping for every character in every language. They pretty much succeeded, and currently have mappings for over 110,000 characters!
An important point to note here – Unicode does not tell you how to encode your characters for storage or transmission. It simply maps the characters to code points. They are generally in the form “U+” followed by a hexadecimal number. For example:
U+0053 – S
U+0051 – Q
U+004C – L
U+0054 – T
U+0075 – u
U+006E – n
U+0061 – a
Those of you paying attention will notice that the code points above are using 4-digit hex numbers, equivalent to 2 bytes or 16 bits. That’s 64k possible mappings, which is way below the 110k they have standardised. Well, Unicode provisioned the use of 5 and 6-digit hex numbers (up to 0x10FFFF), meaning they can currently map over 1 million characters should they wish.
Onto the implementations. You need to store and transmit text data, and you want to use Unicode. Multiple different encodings exist for this. UTF-8 has become a bit of a favourite, and UTF-16 (which extends the older UCS-2) is still popular. UTF is the Unicode Transformation Format, with UCS being Universal Character Set. Many different methods exist, but these are probably the most well known.
I’ll start with UCS-2, as it is the simplest to explain. The system basically used a fixed length 2-byte encoding of the Unicode code point. That’s it. Up to 64k characters allowed, which at the time of its creation was sufficient. Taking my code point example above, we would see the following storage in UCS-2:
Code Point
Character
UCS-2 (hex)
U+0053
S
0x0053
U+0051
Q
0x0051
U+004C
L
0x004C
U+0054
T
0x0054
U+0075
u
0x0075
U+006E
n
0x006E
U+0061
a
0x0061
UTF-16 superseded UCS-2 and extended the implementation to allow code points beyond 0xFFFF. If we go back to where I mentioned the upper range of the current Unicode standard, we have 0x10FFFF. The first byte (0x10) can be thought of as the “plane”, and the 2 bytes following it as the character. Up to 0x10 is allowed, meaning 17 planes. Each 2-byte plane has 0x0000 to 0xFFFF (64k) possible combinations. Plane 0x00 is the first plane, which contains the most common characters and is often referred to as the Basic Multilingual Plane (BMP). Stay with me. UTF-16 uses this in pretty much the same way as UCS-2, and they are almost identical. However UTF-16 makes use of a reserved range, 0xD800 to 0xDFFF, to allow mappings into the other planes. When mapping to other planes, an additional 2 bytes are required for each character, meaning UTF-16 varies between 2-byte and 4-byte encodings depending on whether the character exists within the BMP or not. I’m certainly not going to regurgitate the full implementation when you can read it for yourself online, such as here. Partly because it’s not relevant to this post, but also because I’d have to click on that link to get those details myself…
UTF-8? That’s variable width also. For the ASCII range it uses only one byte. In fact, the first 7 bits are identical to ASCII, as UTF-8 was designed for backwards compatibility, meaning the first 128 characters will appear the same. The 8th bit is used as a flag to signify more bytes are required to store the character, and in that circumstance other flags exist in the encoding to allow 2, 3 or 4 bytes for a character.
UTF-8’s popularity comes from its flexibility. When passing characters in the ASCII range, UTF-8 needs no conversion, it is identical to ASCII and uses a single byte per character. It only requires extra bytes for characters outside this range such as for non-Latin characters and those outside the BMP. The prevalence of English across the web for example, means UTF-8 is mostly 1 byte per character but provides the flexibility to use other character sets. Compare this to UTF-16 which requires at least 2 bytes per character – typically double the size. Across the internet this can make a big difference.
SQL Server
SQL Server has two types of text storage, [var]char and n[var]char. It’s pretty simple really. The first is a 1-byte ASCII encoding, and the second is the 2-byte UCS-2 encoding of Unicode.
The upper 128 characters in the [var]char data type are determined by the Collation of the database, so this becomes very important when moving data in and out. Ultimately the data is stored as a 1-byte number between 0 and 255, but the Collation determines the character and therefore the glyph you see when extracting the data. It can also have an effect on clients/software used to import and export the data. Some software will attempt to convert the text encoding depending on the supplied settings, therefore knowing the encoding is vital to avoid unwanted results.
An Example
A great example in the current world, is migrating a database from a local instance to WASD using the SQL Azure Migration Wizard, available on Codeplex here: http://sqlazuremw.codeplex.com/
It’s a great tool that essentially provides a wrapper for the bcp utility, automatically generating bcp commands to extract data from the chosen databases and objects, then creates the objects in Azure and bcp’s the data in. There are also various checks performed in between for compatibility.
Let’s say both our local database and our Windows Azure SQL Database are using the SQL collation SQL_Latin1_General_CP1_CI_AS. Often the local database will use the Windows collation Latin1_General_CI_AS, which is almost identical, however for this example I wanted them the same.
I create a table in the local database for migration, and insert a value:
It looks like a normal string being inserted, but look closer. The first apostrophe doesn’t need escaping as it’s a curly apostrophe and actually sits outside the normal character range of 32-127 for this collation. It is actually character 146, or in hex 0x92. I run a quick query to look at the data:
I’ve highlighted the difference above. The 6th character (in red) is our curly apostrophe with a value of 0x92 (146). The 19th character (in blue) is a standard apostrophe with a value of 0x27 (39).
As a comparison I run the same SQL on my WASD, the only difference being the suffix on the table name to identify the platform:
I run the SELECT to see how the results compare:
Identical, we see the same results.
Now to run the Azure Migration Wizard. Leaving all the defaults, I select the option to analyze/migrate a database, then connect to my local instance and select the relevant database, in my case the database was called DBA.
I select a specific object, namely my new table dbo.migrationtest_local, and generate the SQL. It generates the CREATE TABLE statement, and also displays the bcp commands it will use. Here is my export bcp command:
The first 2 bytes in red are the data length, in reverse order, i.e. we have 0x001A, or 26, bytes. Also highlighted are the two apostrophes, and you can see that they have the same binary value as we saw in the database. All good so far.
Next we connect to WASD via the wizard, select our target database, and execute the SQL and bcp command to create the table and import the data.
I run a SELECT against the new table in my SQL Database (note the table name – it is the same as our local database as the SQL was generated by the wizard):
Uh-oh! That’s not right is it? What has happened? We know the collation is the same, and the data looked correct when we ran the same SQL statements above.
Going back to the SQL Azure Migration Wizard, I grab the bcp command for the import:
The import statement adds a few parameters, such as the credentials for starters which I’ve removed, but also batch size and packet size. However, notice the one key omission? Yup, the –C RAW option is not there. By default, the tool isn’t configured to use it for import. When omitted, bcp defaults to the –C OEM option, or in other words Original Equipment Manufacturer. This means conversion. Not only that, but conversion based on the client, which in our case involves the host nodes in Azure, NOT just our SQL Database.
The converted character value of 0xC6 (198) appears to come from code page 850. Both the curly apostrophe in our database collation AND the diphthong of AE from code page 850, map to the same Unicode code point of U+0092. It seems the host node is using code page 850, most likely in the physical host database, and has converted the binary data before insertion.
The fix? In this case using the –C RAW option for both export and import would work, or even omitting it for both. This can be done in the SQL Azure Migration Wizard config file, or of course you can perform the tasks manually.
Conclusion
Knowing how text is stored and encoded is vital when you work with data, as is recognising the signs that something is wrong, or hasn’t converted correctly. Different software and different machines can interpret text in different ways, so always try to be aware of any non-standard characters in your data and account for them when moving data around.
I have only touched on the subject of text encoding and collations, and will probably write further posts going into more depth, but as a starting point I think every data professional should know the details covered in this post. It may save a lot of head scratching in the future when your text doesn’t look quite how you expected.
