If you’re getting an error in SQL Server that reads “The least function requires 1 to 254 arguments“, it’s probably because you’re either passing too few or too many arguments to the LEAST() function.

As the error message states, the LEAST() function requires at least 1 argument, and no more than 254 arguments.

To fix this issue, be sure to pass at least 1 argument, and no more than 254 arguments when using the LEAST() function.

Example of Error

Here’s an example of code that produces the error:

SELECT LEAST();

Result:

Msg 189, Level 15, State 1, Server 19ff05754025, Line 1
The least function requires 1 to 254 arguments.

In this example I didn’t pass any arguments.

We get the same error when we pass too many arguments:

SELECT LEAST( 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255 );

Result:

Msg 189, Level 15, State 1, Server 19ff05754025, Line 1
The least function requires 1 to 254 arguments.

In this case I passed 255 arguments, which is over the 254 limit.

And here’s and example that references a database table:

SELECT LEAST() FROM Scores;

Result:

Msg 189, Level 15, State 1, Server 39dddda85240, Line 1
The least function requires 1 to 254 arguments.

By not passing any arguments, I didn’t specify any columns to evaluate.

Solution

As mentioned, to fix this issue, be sure to pass at least 1 argument, and no more than 254 arguments when using the LEAST() function.

Example:

SELECT LEAST( 3, 2 );

Result:

2

And here’s an example that references a table:

SELECT 
  LEAST( Game1, Game2, Game3 ) AS "Lowest Score"
FROM Scores;

Result:

Lowest Score
------------
          15
          19
          10

In this case Game1, Game2, and Game3 are the names of columns in the Scores table, and for each row I returned the lowest value out of all three columns.