புலத்தின் பெயர் மாறவில்லை, ஆனால் பொருள் மாறிவிட்டது, மேலும் கீழ்நிலையில் ஒரு பிழை ஏற்பட்டது: பிரித்தெடுத்தல் முடிவில் பதிப்பு எண்ணைச் சேர்க்கவும்

இந்தக் கட்டுரை டெவலப்பர்கள் மற்றும் ஆவணப் பிரித்தெடுக்கும் இடைமுகங்களைப் பராமரிக்கும் கீழ்நிலை தரவுக் குழுக்களுக்காக எழுதப்பட்டது. பிரித்தெடுத்தல் முடிவுகள் மேம்படுத்தப்பட்ட பிறகு, புலத்தின் பெயர்கள் மாறாமல் இருக்கலாம், ஆனால் அவற்றின் அர்த்தங்கள் வேறுபட்டதாக இருக்கும். எடுத்துக்காட்டாக, amount ஆனது "ஃபென்" இலிருந்து "யுவான்" ஆக மாற்றப்பட்டால், வகை சரிபார்ப்பு இன்னும் கடந்து செல்லும், ஆனால் வணிக எண்கள் அளவு இரண்டு ஆர்டர்களால் வேறுபடலாம்.

இந்த வகையான சிக்கலைக் கையாள, பதிப்பு எண்கள், தெளிவான இடம்பெயர்வு செயல்பாடுகள் மற்றும் இடம்பெயர்வு பதிவுகளை எவ்வாறு பயன்படுத்துவது என்பதை பின்வரும் விளக்குகிறது. இதைப் படித்த பிறகு, எந்த மேம்படுத்தல்களுக்கு பதிப்பு மாறுதல் தேவை என்பதையும், இடம்பெயர்வின் போது என்ன தகவலைத் தக்கவைக்க வேண்டும் என்பதையும் நீங்கள் தீர்மானிக்கலாம்.

இந்தக் கட்டுரையில் உள்ள எடுத்துக்காட்டுகள் செயற்கை மாதிரிகளைப் பயன்படுத்துகின்றன, மேலும் குறியீடு தனிமைப்படுத்தப்பட்ட சூழலில் எடுத்துக்காட்டுகளால் சரிபார்க்கப்பட்டது. இது அனைத்து உண்மையான கோப்புகள் அல்லது தயாரிப்பு விளைவுகளுக்கு உத்தரவாதம் அளிக்காது. முக்கியமான ஆவணங்களைச் செயலாக்குவதற்கு முன், அசல் ஆவணங்களை வைத்து, உரையில் உள்ள எல்லைகள் மற்றும் ஏற்றுக்கொள்ளும் உருப்படிகளின்படி அவற்றை மதிப்பாய்வு செய்யவும்.

புலத்தின் பெயர் மாறவில்லை ஆனால் அதன் பொருள் மாறிவிட்டது. அதை எப்படி சமாளிப்பது? ஒரு வாக்கியத்தின் முடிவு

ஒவ்வொரு வெளியீட்டையும் schema_version உடன் லேபிளிடுங்கள் மற்றும் புதிய பதிப்பை லேபிளிடுவதற்குப் பதிலாக தரவின் வெவ்வேறு பதிப்புகளை மாற்றுவதற்கு வெளிப்படையான இடம்பெயர்வு செயல்பாடுகளைப் பயன்படுத்தவும்.

பதிப்பு எண் சொற்பொருளுடன் செல்ல வேண்டும்

ஒரு புலத்தைச் சேர்ப்பது என்பது அலகுகளை மாற்றுவது போல் அல்ல. நீங்கள் ஒவ்வொரு வெளியீட்டையும் schema_version ஐ வழங்கலாம் மற்றும் பதிப்பின் அடிப்படையில் வேலிடேட்டர்கள் மற்றும் இடம்பெயர்வு செயல்பாடுகளைத் தேர்ந்தெடுக்கலாம்.

பதிப்பு எண்கள் கணினியைப் பாதுகாக்காது. அனைத்து பதிப்புகளும் ஒரே வேறுபடுத்தப்படாத பாகுபடுத்தும் தர்க்கத்தைப் பின்பற்றினால், அது ஒரு அலங்காரப் புலம் மட்டுமே.

பதிப்பு பாகுபடுத்துதலுக்கான திறவுகோல்

• பதிப்பின்படி பாகுபடுத்தும் விதிகளைத் தேர்ந்தெடு: வெவ்வேறு பதிப்புகள் அவற்றின் சொந்த வேலிடேட்டர்களைப் பயன்படுத்துகின்றன.
• இடம்பெயர்வு என்பது ஒரு வெளிப்படையான தரவு மாற்றம்: இது பழைய தரவை நேரடியாக புதிய பதிப்பில் லேபிளிடுவது அல்ல.
• சொற்பொருள் மாற்றங்கள் கண்டறியப்பட வேண்டும்: அலகுகள் மற்றும் துல்லியம் போன்ற விதிகளை மதிப்பாய்வு செய்ய முடியும்.

பின்வரும் எடுத்துக்காட்டில் ஒரு முழு எண் புள்ளிகளை தசம அளவு சரமாக மாற்றுவது எப்படி என்பதைக் காட்டுகிறது.

தணிக்கை செய்யக்கூடிய இடம்பெயர்வு செயல்பாடு

from decimal import Decimal

def migrate(record):
    if record.get("schema_version") != "v1":
        raise ValueError("unexpected input version")
    cents = record.get("amount_cents")
    if type(cents) is not int:
        raise ValueError("integer cents required")
    return {"schema_version": "v2",
            "amount": format(Decimal(cents) / Decimal(100), ".2f"),
            "currency": record["currency"]}

old = {"schema_version": "v1", "amount_cents": 12345, "currency": "USD"}
new = migrate(old)
assert new["amount"] == "123.45"
assert old["amount_cents"] == 12345
assert migrate({**old, "amount_cents": -25})["amount"] == "-0.25"
try:
    migrate({**old, "amount_cents": True})
except ValueError:
    pass
else:
    raise AssertionError("bool is not a monetary integer here")

இந்த உதாரணம், உள்ளீட்டு நாணயம் ஒரு சதவீத அலகு உறவைப் பயன்படுத்துகிறது மற்றும் வெளியீடு இரண்டு தசம இடங்களைக் கொண்டுள்ளது. இது அனைத்து நாணய அலகுகளையும் உள்ளடக்கிய உலகளாவிய மாற்றி அல்ல.

True ஒரு பைசாவாக ஏற்றுக்கொள்வதைத் தவிர்க்க, பைத்தானில் உள்ள முழு எண் துணைப்பிரிவுகளாக பூலியன் மதிப்புகளை type(cents) is int வேண்டுமென்றே விலக்குகிறது.

📊 முக்கிய ஒப்பீடு: பதிப்பு எண் மட்டும் மற்றும் பதிப்பு இடம்பெயர்வு

இடம்பெயர்வு பதிவில் என்ன இருக்க வேண்டும்?

பின்தங்கிய மற்றும் ஆஃப்லோட் செயலாக்கத்தை எளிதாக்குவதற்கு இடம்பெயர்வின் போது பின்வரும் தகவலை பதிவு செய்ய பரிந்துரைக்கப்படுகிறது.

வரலாற்றுப் பிழைகளுடன் எல்லையற்ற இணக்கத்துடன் இருக்க வேண்டாம்

பழைய பதிவின் அலகுகள் நிச்சயமற்றதாக இருந்தால், இடம்பெயர்வு செயல்பாடு யூகிக்கக்கூடாது. ஒரு வெளிப்படையான தோல்வியைத் திரும்பப் பெறுவது, பழைய தரவைத் தக்கவைத்துக்கொள்வது மற்றும் கூடுதல் ஆதாரங்களைக் கேட்பது மிகவும் பொருத்தமான அணுகுமுறையாகும்.

ஏற்கனவே பழைய இடைமுகத்தை பயன்படுத்தும் கீழ்நிலை பயனர்களுக்கு, மதிப்பு சொற்பொருள் மாறியிருப்பதை தானாகவே கண்டறியும் என்று எதிர்பார்க்காமல், பதிப்பு மாறுதலும் ஏற்பாடு செய்யப்பட வேண்டும்.

குறிப்புகள்: JSON ஸ்கீமா பொதுவான முக்கிய வார்த்தைகள்

மொழிபெயர்ப்புக்குப் பிந்தைய சரிபார்ப்புக்கும் பதிப்பு விழிப்புணர்வு தேவை

OmniDoc (தயாரிப்பு போர்டல்) மொழிபெயர்ப்புகளைச் சரிபார்க்க பிரித்தெடுக்கப்பட்ட புலங்களைப் பயன்படுத்தும் போது, புலங்கள் எந்த நெறிமுறையால் உருவாக்கப்பட்டன என்பதை நீங்கள் குறிப்பிட வேண்டும். மூலக் கோப்புகள், பிரித்தெடுத்தல் விதிகள் அல்லது இலக்கு மொழியில் ஏற்படும் மாற்றங்கள் ஒப்பீட்டு முறையைப் பாதிக்கலாம்.

பதிப்புத் தகவலைப் பாதுகாப்பது, "ஏன் இந்த நேரம் கடந்த முறையிலிருந்து வேறுபட்டது" என்பதை மாடல் உறுதியற்ற தன்மைக்குக் காரணமாகக் கூறுவதற்குப் பதிலாக சரிசெய்தல் சிக்கலாக மாற்றலாம்.

🎯 எந்த முறை உங்களுக்கு ஏற்றது?

நீங்கள் ஒரு புதிய புலத்தைச் சேர்த்தால்

ஒரு புதிய புலத்தை நேரடியாகச் சேர்த்து schema_version ஐ வெளியீட்டில் பதிவு செய்யவும்.

நீங்கள் ஒரு புலத்தின் அலகு அல்லது பொருளை மாற்ற விரும்பினால்

புதிய பதிப்பிற்கான சுயாதீன மதிப்பீட்டாளர்கள் மற்றும் இடம்பெயர்வு செயல்பாடுகளை எழுதவும், மேலும் பழைய பாகுபடுத்தும் தர்க்கத்தை மீண்டும் பயன்படுத்த வேண்டாம்.

உங்கள் வரலாற்று தரவு அலகு தெளிவாக இல்லை என்றால்

இடம்பெயர்வு தோல்வியடைந்தது என்பதைத் தெளிவுபடுத்தவும், அசல் தரவைத் தக்கவைத்து, செயலாக்குவதற்கு முன் ஆதாரங்களைச் சேர்க்கவும்.

❓ அடிக்கடி கேட்கப்படும் கேள்விகள் (FAQ)

1. வெளியீட்டில் பதிப்பு எண்ணைச் சேர்த்தால் போதுமா?

போதாது. பதிப்பு எண் என்பது ஒரு லேபிள் மட்டுமே, மேலும் எல்லா பதிப்புகளும் ஒரே பாகுபடுத்தும் லாஜிக்கைப் பயன்படுத்தினால் வணிக அர்த்தத்தைப் பாதுகாக்க முடியாது.

2. இடம்பெயர்வு செயல்பாடு ஏன் பூலியன் மதிப்புகளை விலக்குகிறது?

பைத்தானில் உள்ள பூலியன் மதிப்புகள் முழு எண்களின் துணைப்பிரிவாகும், மேலும் type(cents) is int True பைசாவாக ஏற்றுக்கொள்ளப்படுவதைத் தடுக்கிறது.

3. பழைய பதிவு அலகு நிச்சயமற்றதாக இருக்கும்போது நீங்கள் என்ன செய்ய வேண்டும்?

இடம்பெயர்தல் செயல்பாடுகளை யூகிக்கக்கூடாது. ஒரு வெளிப்படையான தோல்வி திரும்பப் பெறப்பட வேண்டும், பழைய தரவு தக்கவைக்கப்பட வேண்டும், மேலும் கூடுதல் சான்றுகள் கோரப்பட வேண்டும்.

4. இடம்பெயர்வு பதிவுகளில் என்ன தகவல்களைச் சேமிக்க வேண்டும்?

குறைந்தபட்சம், உள்ளீடு மற்றும் வெளியீட்டு பதிப்புகள், இடம்பெயர்வு நிரல் பதிப்பு, அசல் பதிவு அடையாளம் மற்றும் தோல்விக்கான காரணம் ஆகியவை அடங்கும்.

📝 சுருக்கம்

புலம் பெயர் மாறாமல் இருப்பதால் பொருள் மாறாமல் உள்ளது என்று அர்த்தமில்லை. வெளியீட்டைப் பதிப்பித்தல் மற்றும் வெளிப்படையான இடம்பெயர்வு செயல்பாடுகள் மற்றும் இடம்பெயர்வு பதிவுகளுடன் சொற்பொருள் மாற்றங்களைக் கையாளுதல் ஆகியவை கீழ்நிலையில் அமைதியான பிழைகளின் அபாயத்தைக் கணிசமாகக் குறைக்கும்.

இப்போது முயற்சிக்கவும்: அசல் தளவமைப்பைத் தக்கவைத்து, மொழிபெயர்ப்பைத் தொடங்க ஆவணத்தைப் பதிவேற்றவும்