Obsługa wartości dziesiętnych i pieniężnych

Sterownik mssql-python mapuje typy danych dziesiętnych, numerycznych i pieniężnych SQL Server na Python, decimal.Decimal aby dokładnie prowadzić obliczenia finansowe i naukowe. SQL Server oferuje następujące precyzyjne typy numeryczne:

Typ SQL	Typ języka Python	Dokładność	Przypadek użycia
decimal(p,s)	`decimal.Decimal`	1-38 cyfr	Dokładne obliczenia
numeryczne (p,s)	`decimal.Decimal`	1-38 cyfr	Tak samo jak dziesiętne
money	`decimal.Decimal`	19 cyfr, 4 dziesiętne	Waluta
smallmoney	`decimal.Decimal`	10 cyfr, 4 dziesiętne	Mała waluta
float	`float`	~15 cyfr	W przybliżeniu
prawdziwy	`float`	~7 cyfr	W przybliżeniu

Typ dziesiętny w Python

Otrzymuj wartości dziesiętne

Kolumny dziesiętne zwracają obiekty Pythondecimal.Decimal:

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')

Wyślij wartości dziesiętne

Przekazuj obiekty Decimal do precyzyjnego wstawiania:

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()

Unikaj typu float w danych finansowych

Typy float mają problemy z precyzją, które sprawiają, że nie nadają się do obliczeń finansowych. Zawsze używaj Decimal, aby uzyskać dokładne wyniki:

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 pieniędzy

Praca z kolumnami walutowymi

Pobieranie i aktualizowanie kolumn typu money w SQL Server za pomocą obiektów Decimal w Pythonie:

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()

Formatowanie walut

Formatuj wartości dziesiętne jako ciągi walut z symbolami i separatorami przecinków:

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

Precyzja dziesiętna i skala

Zrozum precyzję i skalę

Precyzja (p): Całkowita liczba cyfr
Skala: Liczba cyfr po przecinku dziesiętnym

Na przykład może decimal(10, 2) przechowywać wartości od -99999999.99 do 99999999.99, natomiast decimal(5, 4) od -9.9999 do 9.9999.

Określ precyzję parametrów

Sterownik mssql-python automatycznie wywnioskuje precyzję i skalę na podstawie wartości dziesiętnych:

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()

Sterowanie zaokrąglaniem

Użyj quantize() metody zaokrąglenia wartości dziesiętnych do określonej skali:

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')

Obliczenia finansowe

Arytmetyka bezpieczna

Implementuj obliczenia finansowe za pomocą systemu dziesiętnego z odpowiednim zaokrągleniem:

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")})

Obliczania procentowe

Obliczaj procentowe rabaty i korekty:

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}")

Podzielone kwoty

Podziel łączną kwotę równomiernie między wiele podmiotów, z uwzględnieniem reszt:

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

Operacje agregowania

SUM i AVG dla liczb dziesiętnych

Funkcje agregacji SQL Server zwracają typy dziesiętne dla precyzji:

# 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"))

Obsługa NULL w agregacjach

Funkcje agregacji SQL Server mogą zwracać sygnałyNone, gdy żaden wiersz nie pasuje do zapytania:

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")

Przetworniki wyjściowe dla systemu dziesiętnego

Konwertery wyjściowe używają typu Python pokazanego w cursor.description jako klucza, a nie liczby całkowitej reprezentującej typ SQL ODBC. Zarejestruj konwerter za pomocą decimal.Decimal, aby działał dla kolumn decimal, numeric, money i smallmoney, które wszystkie są mapowane na decimal.Decimal.

Przekształc w float (gdy precyzja nie jest krytyczna)

Aby uzyskać kompatybilność z bibliotekami oczekującymi wartości float, zdefiniuj konwerter wyjściowy:

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'>

Niestandardowy konwerter formatu walutowego

Zdefiniuj niestandardowy konwerter wyjściowy, aby automatycznie formatował wartości dziesiętne jako ciągi walutowe:

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"

Często używane wzorce

Konwersja walut

Przelicz kwoty pieniężne między walutami za pomocą kursów wymiany:

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}")

Aktualizacje salda w transakcjach

Używaj transakcji z odpowiednimi wskazówkami dotyczącymi blokowania, aby zapewnić atomowe transfery środków i zapobiec utraconym aktualizacjom:

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"))

Transfer blokuje z góry oba wiersze, zaczynając od najniższego identyfikatora, wykonując osobne SELECT ... WITH (UPDLOCK) dla każdego konta w posortowanej kolejności. UPDLOCK zapobiega utracie wzorca aktualizacji, gdy dwie transakcje odczytują to samo saldo i stosują aktualizacje na podstawie nieaktualnych danych. Wydanie blokad jako oddzielnych wyciągów w uporządkowanej kolejności gwarantuje rozkaz przejęcia, zapobiegając nabyciu blokad w odwrotnej kolejności przez przeciwne transfery między tymi samymi dwoma kontami i impasowi.

Wkładka zbiorcza z liczbami dziesiętnymi

Wstaw wiele wierszy z wartościami dziesiętnymi za 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()

Najlepsze rozwiązania

Zawsze używaj Decimal do matematyki finansowej

Nigdy nie używaj typu float do obliczeń finansowych; zawsze używaj typu Decimal, aby zapewnić precyzję:

# 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')

Użyj konstruktorów stringów

Skonstruuj wartości dziesiętne z ciągów znaków, aby uniknąć niedokładności float:

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

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

Zawsze okrągły przed ekspozycją lub przechowywaniem

Zaokrąglić wartości dziesiętne do odpowiedniej skali przed wyświetleniem lub utrwaleniem w bazie danych:

from decimal import Decimal, ROUND_HALF_UP

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

Ustaw kontekst dziesiętny, jeśli jest potrzeba

Precyzja kontekstu dziesiętnego wpływa na wyniki obliczeń, a nie na wartości parsowane z ciągów znaków lub odczytywane z bazy danych. Zapytanie zawsze zwraca wartość money lub decimal z pełną zapisaną skalą, niezależnie od getcontext().prec. Kontekst działa dopiero wtedy, gdy go obliczysz. Aby zobaczyć działanie precyzji, wykonaj operację taką jak dzielenie.

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)

Opinia

Czy ta strona była pomocna?

Last updated on 2026-07-22