Note that if you're interested in learning about Oracle Database 12c, there's an updated version of this post here.
When it comes to gathering statistics, one of the most critical decisions you have to make is, what sample size should be used? A 100% sample will ensure accurate statistics but could take a really long time. Whereas a 1% sample will finish quickly but could result in poor statistics.
The ESTIMATE_PERCENT parameter in the DBMS_STATS.GATHER_*_STATS procedures controls the sample size used when gathering statistics and its default value is AUTO_SAMPLE_SIZE.
In an earlier blog post, we talked about the new implementation of AUTO_SAMPLE_SIZE in Oracle Database 11g in terms of its improvements in the speed and accuracy of statistics gathering compared to the old AUTO_SAMPLE_SIZE prior to Oracle Database 11g.
In this post, we will offer a closer look at the how the new AUTO_SAMPLE_SIZE algorithm works and how it affects the accuracy of the statistics being gathered.
Before we delve into how the new algorithm works, let us briefly recap how the old algorithm works and its downsides. The old AUTO_SAMPLE_SIZE used the following approach:
Step 1. Oracle starts with a small sampling percentage. If histograms need to be gathered, Oracle might materialize the sample, depending on the sampling percentage.
Step 2. Oracle gathers basic column statistics on the sample. For example, suppose a table T has only one column C1, then the basic stats gathering query looks like below (this is not the exact syntax we use but a simplified version for illustration purpose):
Query 1 Query Gathering Basic Column Statistics Using AUTO_SAMPLE_SIZE Prior to 11g
The select list items in the query correspond to number of rows in table T, number of non-null values, number of distinct values, total column length, minimal and maximal values of column C1 respectively. “X.0000000000” in the FROM clause is the sampling percentage determined by Oracle.
Step 3: if histograms need to be gathered, Oracle issues a SQL query on the sample for each column that requires a histogram.
Step 4: For each column that requires a histogram, Oracle uses several metrics to determine whether the current sample is sufficient:
Step 5: If all metrics in step 4 pass, Oracle concludes that the current sample size is sufficient and the histogram creation for that column is complete. Otherwise, it bumps up the sample size and goes though the above steps again until it finds a satisfactory sample or reaches 100% sampling.
Note that step 3 to step 5 are done per column. For example, if there are 3 columns in the table that require histograms. In the first iteration, we get a sample and materialize it. We issue 3 queries, one per column, on the same materialized sample to gather histograms. Suppose Oracle determines that the sample is sufficient for columns 1 and 2 but insufficient for column 3. Then we bump up the sample size. In the second iteration, only 1 query is issued on the sample to gather histogram for column 3.
As you can see the old AUTO_SAMPLE_SIZE can be inefficient if several iterations are required. A dominating contributor for several iterations is the inability to gather accurate NDVs using a small sample. If there is a skew in the data, a lot of low frequency values may not make into the sample and thus the sample fails the NDV metric.
In Oracle Database 11g, we use a completely different approach for gathering basic column statistics. We issue the following query to gather basic column statistics (again this is a simplified version for illustration purpose).
You will notice in the new basic column statistics gathering query, no sampling clause is used. Instead we do a full table scan. Also, there is no more count(distinct C1) to gather NDV for C1. Instead, during the execution we inject a special statistics gathering row source to this query. The special gathering row source uses a one-pass, hash-based distinct algorithm to gather NDV. More information on how this algorithm works can be found in the paper, “efficient and scalable statistics gathering for large databases in Oracle 11g”. The algorithm requires a full scan of the data, uses a bounded amount of memory and yields a highly accurate NDV that is nearly identical to a 100 percent sampling (can be proven mathematically). The special statistics gathering row source also gathers the number of rows, number of nulls and average column length on the side. Since we do a full scan on the table, the number of rows, average column length, minimal and maximal values are 100% accurate.
AUTO_SAMPLE_SIZE also affects histogram gathering and index statistics gathering in the following ways.
The new AUTO_SAMPLE_SIZE also affects how index statistics are gathered. The flow chart below shows how index statistics are gathered in 11g when AUTO_SAMPLE_SIZE is specified. Index statistics gathering are sampling based. It could potentially go through several iterations because either the sample contained too few blocks or the sample size was too small to properly gather number of distinct keys (NDKs). With the new AUTO_SAMPLE_SIZE algorithm, however, if the index is defined on a single column, or if the index is defined on multiple columns that correspond to a column group, then the NDV of the column or column group will be used as NDK of the index. The index statistics gathering query will NOT gather NDK in such cases. This helps to alleviate the need to bump up sample size for index statistics gathering.
Summary:
Hi Maria,
Very nice information which is very much understandable.
Congrats to your team, keep up the good work. Looking forward to read more on optimizer stuff.
Regards,
Srikar
Thanks for the details simple explanation.
Hi Maria
If a certain set of tables are loaded data with files everyday, what sampling size should we be specifying?
Considering these tables already have more than 5 million rows and everyday files load around 100k to 400k rows. So the data in the files is appended in the table. If sampling percentage is kept 100 it will take a lot of time, plus if only certain percentage of rows are inserted in the table what should we use? Currently I see there code is using analyze table Compute statistics with estimate statistics sample 33%. I know we should be using DBMS stats but want to know if auto sample size will work in this case too and will not take very long to gather statistics.
Thank you.
Hi Rohan,
Auto sample size is highly recommended and you must use DBMS_STATS. It is likely to be as fast as your current approach too, especially if you don't need histogram. If your table is partitioned, look at using incremental statistics management. With this feature, you must use DBMS_STATS and auto sample size.
Regards,
Nigel.
Hi Maria/ Nigel,
I performed the following on a partitioned table -
begin
dbms_stats.gather_table_stats('COMPANY', 'EMPLOYEE', partname => 'EMP_201701', estimate_percent => dbms_stats.auto_sample_size);
end;
After i ran this i noticed Oracle not only gathered statistics for the mentioned partition (EMP_201712) but also gathered for some more partitions. (4 more).
Not sure if anything is wrong in my syntax,but this happened during the day today as well where i ran the above inside an execute immediate since the partition name was dynamically passed and Oracle ended up gathering statistics for the entire table and all 11 indexes on it which resulted it to run for almost an hour.
Is something wrong in my syntax? Why does oracle gather statistics of other partitions as well if i have specifically mentioned only one partition.
The 2 runs i had was one through execute immediate which resulted gathering statistics for all partitions and second one was plain static run where i only ran the above and it ended up running for 4 more partitions.
Can you please provide some insights here? Does auto_sample_size come cause it to do this?
As opposed to this when i ran the below i could see oracle analyzed only that single partition and in dba_tab_partitions i could see only this one getting its last_analzyed updated.
ANALYZE TABLE COMPANY.EMPLOYEE PARTITION(EMP_201712) estimate statistics sample 33 percent;
Regards,
Rohan S.
Hi Rohan,
Note that it's always possible that you have DBMS_STATS global preferences set that are setting options you don't expect. It's always very difficult for me to guess everying about the state of you table prior to gathing stats, but you should try setting granularity to PARTITION. I don't see that auto sample size could be a problem - it is always the right thing to do. Remember that you should update global-level statistics if you update partition-level stats. You can speed that up using incremental stats maintenance. I'm not sure if you are using that, but this will affect the behavior:
https://blogs.oracle.com/optimizer/entry/efficient_statistics_maintenance_for_partitioned
Regards,
Nigel
a question regarding this comment by JL on index' auto sample size: https://twitter.com/JLOracle/status/979044773154652161
"The sample size on auto_sample_size for indexes tends to be ridiculously small, and it's block sampled (to get the clustering factor) which magnifies the risk of error."
Is it (still) true?
Thanks.
Nigel.