Zvládejte desetinné a peněžní hodnoty

Ovladač mssql-python mapuje datové typy SQL Server na Python decimal.Decimal pro přesné finanční a vědecké výpočty. SQL Server poskytuje následující přesné číselné typy:

Typ SQL	Typ Pythonu	Přesnost	Případ použití
decimal(p;s)	`decimal.Decimal`	1-38 číslic	Přesné výpočty
numeric(p;s)	`decimal.Decimal`	1-38 číslic	Stejné jako desetinná
money	`decimal.Decimal`	19 číslic, 4 desetinné čísla	Měna
smallmoney	`decimal.Decimal`	10 číslic, 4 desetinné čísla	Malá měna
float	`float`	~15 číslic	Přibližné
real	`float`	~7 číslic	Přibližné

Datový typ Decimal v Pythonu

Přijímání desetinných hodnot

Desetinné sloupce vracejí Python decimal.Decimal objekty:

from decimal import Decimal
import mssql_python

conn = mssql_python.connect(connection_string)
cursor = conn.cursor()

cursor.execute(
    "SELECT SubTotal, TaxAmt, TotalDue "
    "FROM Sales.SalesOrderHeader WHERE SalesOrderID = 43659"
)
row = cursor.fetchone()

print(type(row.SubTotal))  # <class 'decimal.Decimal'>
print(row.SubTotal)        # Decimal('20565.6206')
print(row.TaxAmt)          # Decimal('1971.5149')
print(row.TotalDue)        # Decimal('23153.2339')

Odesílat desetinné hodnoty

Pro přesné vložení předejte objekty Decimal:

from decimal import Decimal

cursor.execute("""
    CREATE TABLE #ProductDemo (
        Name NVARCHAR(50),
        Price DECIMAL(10,2),
        Cost DECIMAL(10,2)
    )
""")
cursor.execute("""
    INSERT INTO #ProductDemo (Name, Price, Cost)
    VALUES (%(name)s, %(price)s, %(cost)s)
""", {
    "name": "Widget",
    "price": Decimal("199.99"),
    "cost": Decimal("87.50")
})
conn.commit()

Nepoužívejte datový typ float pro finanční data

Plovoucí typy mají problémy s přesností, které je činí nevhodnými pro finanční výpočty. Vždy používejte Decimal pro přesné výsledky:

from decimal import Decimal

# Bad: float has precision issues
price = 0.1 + 0.2  # 0.30000000000000004

# Good: Decimal is exact
price = Decimal("0.1") + Decimal("0.2")  # Decimal('0.3')

# Use string constructor for literal values
correct = Decimal("19.99")  # Exact
avoid = Decimal(19.99)      # Might introduce float imprecision

Typ peněz

Práce s měnovými sloupci

Načítání a aktualizace sloupců peněz v SQL Server pomocí objektů Python Decimal:

from decimal import Decimal

# Create and populate a temp table with a money column
cursor.execute("""
    CREATE TABLE #Accounts (
        ID INT,
        AccountID NVARCHAR(20),
        Balance MONEY
    )
""")
cursor.execute(
    "INSERT INTO #Accounts (ID, AccountID, Balance) VALUES (1, %(acct)s, %(bal)s)",
    {"acct": "ACCT-001", "bal": Decimal("1234.5678")}
)
conn.commit()

cursor.execute("SELECT AccountID, Balance FROM #Accounts WHERE ID = 1")
row = cursor.fetchone()

print(row.Balance)         # Decimal('1234.5678')
print(type(row.Balance))   # <class 'decimal.Decimal'>

# Money arithmetic
cursor.execute("""
    UPDATE #Accounts 
    SET Balance = Balance + %(amount)s 
    WHERE ID = %(id)s
""", {"amount": Decimal("100.00"), "id": 1})
conn.commit()

Formátování měny

Formátujte desetinné hodnoty jako řetězce měn se symboly a čárkami:

from decimal import Decimal

def format_currency(value: Decimal, symbol: str = "$") -> str:
    """Format decimal as currency string."""
    return f"{symbol}{value:,.2f}"

cursor.execute("SELECT TotalDue FROM Sales.SalesOrderHeader")
for row in cursor:
    print(format_currency(row.TotalDue))  # $1,234.56

Desítková přesnost a měřítko

Pochopte přesnost a měřítko

Přesnost (p): Celkový počet číslic
Stupnice(y): Počet číslic za desetinnou čárkou

Například může decimal(10, 2) ukládat hodnoty od -999999999,99 do 99999999,99, zatímco decimal(5, 4) hodnoty od -9,9999 do 9,9999.

Specifikujte přesnost parametrů

Ovladač mssql-python automaticky odvozuje přesnost a škálování z desetinných hodnot:

from decimal import Decimal

# Create a temp table for the measurement value
cursor.execute("CREATE TABLE #Measurements (Value DECIMAL(18,6))")

# The driver infers precision from the Decimal value
value = Decimal("123.456789")
cursor.execute("INSERT INTO #Measurements (Value) VALUES (%(v)s)", {"v": value})
conn.commit()

Ovládání zaokrouhlování

Použijte metodu quantize() zaokrouhlení desetinných hodnot na konkrétní škálu:

from decimal import Decimal, ROUND_HALF_UP, ROUND_DOWN

price = Decimal("19.999")

# Round to 2 decimal places
rounded = price.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
print(rounded)  # Decimal('20.00')

# Round down (truncate)
truncated = price.quantize(Decimal("0.01"), rounding=ROUND_DOWN)
print(truncated)  # Decimal('19.99')

Finanční výpočty

Bezpečná aritmetika

Implementujte finanční výpočty pomocí desetinné metody s správným zaokrouhlováním:

from decimal import Decimal, ROUND_HALF_UP

def calculate_total(price: Decimal, quantity: int, tax_rate: Decimal) -> Decimal:
    """Calculate order total with tax."""
    subtotal = price * quantity
    tax = (subtotal * tax_rate).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
    return subtotal + tax

cursor.execute("SELECT ListPrice FROM Production.Product WHERE ProductID = 1")
price = cursor.fetchval()

total = calculate_total(
    price=price,
    quantity=3,
    tax_rate=Decimal("0.0825")  # 8.25% tax
)

cursor.execute("""
    CREATE TABLE #OrderCalc (
        ProductID INT, Quantity INT, Total DECIMAL(10,2), Tax DECIMAL(10,2)
    )
""")
cursor.execute("""
    INSERT INTO #OrderCalc (ProductID, Quantity, Total, Tax)
    VALUES (%(prod)s, %(qty)s, %(total)s, %(tax)s)
""", {"prod": 1, "qty": 3, "total": total, "tax": total * Decimal("0.0825")})

Procentuální výpočty

Vypočítat procentuální slevy a úpravy:

from decimal import Decimal

def calculate_discount(price: Decimal, discount_percent: Decimal) -> Decimal:
    """Calculate discounted price."""
    discount = (price * discount_percent / 100).quantize(Decimal("0.01"))
    return price - discount

original = Decimal("99.99")
discounted = calculate_discount(original, Decimal("15"))  # 15% off
print(f"Original: ${original}, After discount: ${discounted}")

Rozdělené částky

Rovnoměrně rozdělte celkovou částku mezi více účastníků se zohledněním zbytků:

from decimal import Decimal, ROUND_DOWN

def split_amount(total: Decimal, ways: int) -> list[Decimal]:
    """Split amount evenly, handling remainder."""
    per_person = (total / ways).quantize(Decimal("0.01"), rounding=ROUND_DOWN)
    remainder = total - (per_person * ways)
    
    amounts = [per_person] * ways
    # Add remainder to first person
    amounts[0] += remainder
    return amounts

total = Decimal("100.00")
split = split_amount(total, 3)
print(split)  # [Decimal('33.34'), Decimal('33.33'), Decimal('33.33')]
print(sum(split))  # Decimal('100.00') - always equals original

Agregační operace

SUM a AVG s desetinnými čísly

Agregační funkce SQL Server vracejí desetinné typy pro přesnost:

# SUM preserves decimal type
cursor.execute("SELECT SUM(TotalDue) AS TotalSales FROM Sales.SalesOrderHeader")
total_sales = cursor.fetchval()
print(type(total_sales))  # <class 'decimal.Decimal'>

# AVG might return more decimal places
cursor.execute("SELECT AVG(ListPrice) AS AvgPrice FROM Production.Product")
avg_price = cursor.fetchval()
# Round to desired precision
avg_price = avg_price.quantize(Decimal("0.01"))

Práce s hodnotou NULL v agregačních funkcích

Agregační funkce SQL Server mohou vrátitNone, když žádný řádek neodpovídá dotazu:

cursor.execute("SELECT SUM(TotalDue) FROM Sales.SalesOrderHeader WHERE CustomerID = 0")
total_discount = cursor.fetchval()

# SUM returns NULL if no rows match
if total_discount is None:
    total_discount = Decimal("0.00")

Výstupní převodníky pro desetinné

Výstupní převodníky používají jako klíč typ Pythonu uvedený v cursor.description, nikoli celočíselný typ ODBC SQL. Zaregistrujte převodník s decimal.Decimal, aby fungoval pro sloupce decimal, numeric, money a smallmoney, které se všechny mapují na decimal.Decimal.

Převést na plovoucí (když přesnost není kritická)

Pro kompatibilitu s knihovnami, které očekávají plovoucí hodnoty, definujte výstupní převodník:

import mssql_python
from decimal import Decimal

def decimal_to_float(value):
    """Convert Decimal to float."""
    if value is None:
        return None
    return float(value)  # value is already a Decimal object

conn = mssql_python.connect(connection_string)

# Convert decimals to float for compatibility with libraries that expect float
conn.add_output_converter(Decimal, decimal_to_float)

cursor = conn.cursor()
cursor.execute("SELECT ListPrice FROM Production.Product WHERE ProductID = 1")
row = cursor.fetchone()
print(type(row.ListPrice))  # <class 'float'>

Převodník vlastního formátování měny

Definujte vlastní výstupní převodník, který automaticky formátuje desetinné hodnoty jako řetězce měn:

from decimal import Decimal

def money_to_string(value):
    """Convert Decimal to formatted string."""
    if value is None:
        return None
    return f"${value:,.2f}"  # value is already a Decimal object

conn.add_output_converter(Decimal, money_to_string)

cursor = conn.cursor()
cursor.execute("CREATE TABLE #Accounts (Balance DECIMAL(19,4))")
cursor.execute(
    "INSERT INTO #Accounts (Balance) VALUES (%(bal)s)",
    {"bal": Decimal("1234.56")}
)
conn.commit()

cursor.execute("SELECT Balance FROM #Accounts")
for row in cursor:
    print(row.Balance)  # "$1,234.56"

Obvyklé scénáře

Převod měny

Převádějte peněžní částky mezi měnami pomocí směnných kurzů:

from decimal import Decimal

def convert_currency(amount: Decimal, rate: Decimal) -> Decimal:
    """Convert currency at given exchange rate."""
    return (amount * rate).quantize(Decimal("0.01"))

usd_amount = Decimal("100.00")
eur_rate = Decimal("0.92")
eur_amount = convert_currency(usd_amount, eur_rate)
print(f"${usd_amount} = €{eur_amount}")

Aktualizace zůstatku spolu s transakcemi

Používejte transakce s odpovídajícími hinty zámků, abyste zajistili atomické převody finančních prostředků a zabránili ztraceným aktualizacím:

from decimal import Decimal

def transfer_funds(conn, from_account: int, to_account: int, amount: Decimal):
    """Transfer funds between accounts atomically."""
    cursor = conn.cursor()
    conn.autocommit = False
    
    try:
        balances = {}
        for account_id in sorted((from_account, to_account)):
            cursor.execute(
                "SELECT Balance FROM #Accounts WITH (UPDLOCK) WHERE ID = %(id)s",
                {"id": account_id}
            )
            row = cursor.fetchone()
            if row is None:
                raise ValueError(f"Account {account_id} not found")
            balances[account_id] = row.Balance
        
        if balances[from_account] < amount:
            raise ValueError("Insufficient funds")
        
        # Debit source
        cursor.execute("""
            UPDATE #Accounts SET Balance = Balance - %(amount)s
            WHERE ID = %(id)s
        """, {"amount": amount, "id": from_account})
        
        # Credit destination
        cursor.execute("""
            UPDATE #Accounts SET Balance = Balance + %(amount)s
            WHERE ID = %(id)s
        """, {"amount": amount, "id": to_account})
        
        conn.commit()
        
    except Exception:
        conn.rollback()
        raise
    finally:
        conn.autocommit = True

# Set up demo accounts
cursor = conn.cursor()
cursor.execute("CREATE TABLE #Accounts (ID INT, Balance MONEY)")
cursor.executemany(
    "INSERT INTO #Accounts (ID, Balance) VALUES (%(id)s, %(bal)s)",
    [{"id": 1, "bal": Decimal("1000.00")}, {"id": 2, "bal": Decimal("500.00")}]
)
conn.commit()

# Usage
transfer_funds(conn, from_account=1, to_account=2, amount=Decimal("500.00"))

Převod uzamkne oba řádky předem, nejprve ten s nižším ID, a to provedením samostatného SELECT ... WITH (UPDLOCK) pro každý z účtů v seřazeném pořadí. UPDLOCK Zabraňuje ztracenému vzoru aktualizací, kdy dvě transakce vyčítají stejný zůstatek a aplikují aktualizace na základě zastaralých dat. Právě udělování zámků jako samostatných příkazů v seřazeném pořadí zaručuje pořadí jejich získávání a brání tomu, aby protisměrné převody mezi stejnými dvěma účty získaly zámky v opačném pořadí a způsobily tak uváznutí.

Hromadné vložení s desetinnými hodnotami

Vložte více řádků s desetinnými hodnotami pomocí executemany():

from decimal import Decimal

cursor.execute("""
    CREATE TABLE #BulkProducts (
        Name NVARCHAR(50),
        Price DECIMAL(10,2),
        Cost DECIMAL(10,2)
    )
""")

products = [
    {"name": "Widget A", "price": Decimal("19.99"), "cost": Decimal("8.50")},
    {"name": "Widget B", "price": Decimal("29.99"), "cost": Decimal("12.75")},
    {"name": "Widget C", "price": Decimal("39.99"), "cost": Decimal("18.00")},
]

cursor.executemany("""
    INSERT INTO #BulkProducts (Name, Price, Cost)
    VALUES (%(name)s, %(price)s, %(cost)s)
""", products)
conn.commit()

Osvědčené postupy

Vždy používejte Decimal pro finanční matematiku

Nikdy nepoužívejte plovoucí pro finanční výpočty; pro přesnost vždy používejte desetinný typ:

# Wrong: float precision issues
price = 0.10
quantity = 3
total = price * quantity  # 0.30000000000000004

# Correct: Decimal is exact
price = Decimal("0.10")
quantity = 3
total = price * quantity  # Decimal('0.30')

Použijte konstruktory řetězce

Sestavte desetinné hodnoty ze řetězců, abyste předešli nepřesnosti plovoucího pohybu:

# Good: exact value
amount = Decimal("123.45")

# Risky: might inherit float imprecision
amount = Decimal(123.45)  # Could be 123.4500000000000028...

Vždy kulaté před vystavením nebo uložením

Zaokrouhlte desetinné hodnoty na odpovídající škálu před zobrazením nebo uložením v databázi:

from decimal import Decimal, ROUND_HALF_UP

calculated = Decimal("123.456789")
display = calculated.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)

Nastavte desetinný kontext, pokud je to potřeba

Přesnost desetinného kontextu ovlivňuje výsledky výpočtů, nikoli hodnoty parsované z řetězců nebo čtené z databáze. Dotaz vždy vrací hodnotu money nebo decimal v plném uloženém měřítku bez ohledu na getcontext().prec. Kontext se projeví až tehdy, když s ním počítáte. Pro zjištění účinnosti přesnosti proveďte operaci, například dělení.

from decimal import Decimal, getcontext

# A money value read from SQL Server arrives at its full stored scale,
# regardless of the context precision.
cursor.execute(
    "SELECT SubTotal FROM Sales.SalesOrderHeader WHERE SalesOrderID = 43659"
)
subtotal = cursor.fetchone().SubTotal
print(subtotal)  # Decimal('20565.6206')

# The context precision governs the calculation, not the fetched value.
# Split the subtotal into three equal installments.
getcontext().prec = 10
print(subtotal / 3)  # 6855.206867 (10 significant digits)

getcontext().prec = 28  # Reset to default
print(subtotal / 3)  # 6855.206866666666666666666667 (28 significant digits)

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-07-22