10.5.17 MySQLCursor.description Property — MySQL Connectors 1.0

10.5.17 Свойство MySQLCursor.description

Синтаксис:

tuples = cursor.description

Это свойство только для чтения возвращает список кортежей, описывающих столбцы в наборе результатов. Каждый кортеж в списке содержит значения следующим образом:

(column_name,
 type,
 None,
 None,
 None,
 None,
 null_ok,
 column_flags)

Следующий пример показывает, как интерпретировать description кортежи:

import mysql.connector
from mysql.connector import FieldType

...

cursor.execute("SELECT emp_no, last_name, hire_date "
               "FROM employees WHERE emp_no = %s", (123,))
for i in range(len(cursor.description)):
  print("Column {}:".format(i+1))
  desc = cursor.description[i]
  print("  column_name = {}".format(desc[0]))
  print("  type = {} ({})".format(desc[1], FieldType.get_info(desc[1])))
  print("  null_ok = {}".format(desc[6]))
  print("  column_flags = {}".format(desc[7]))

Вывод выглядит так:

Column 1:
  column_name = emp_no
  type = 3 (LONG)
  null_ok = 0
  column_flags = 20483
Column 2:
  column_name = last_name
  type = 253 (VAR_STRING)
  null_ok = 0
  column_flags = 4097
Column 3:
  column_name = hire_date
  type = 10 (DATE)
  null_ok = 0
  column_flags = 4225

Значение column_flags является экземпляром класса constants.FieldFlag. Чтобы увидеть, как его интерпретировать, сделайте следующее:

>>> from mysql.connector import FieldFlag
>>> FieldFlag.desc