Атрибут attrs
Атрибут attrs применяется к объекту DataFrame
и позволяет сохранять произвольные метаданные. Этот
атрибут представляет собой словарь, в который можно
записывать любую дополнительную информацию, связанную
с таблицей, например, описание, дату создания, источник
данных или версию набора данных. Метаданные сохраняются
при передаче объекта в другие функции и могут быть
использованы для документирования или отслеживания
происхождения данных.
Синтаксис
# Чтение атрибута
df.attrs
# Запись атрибута
df.attrs = {'key': 'value'}
# Изменение отдельного значения
df.attrs['key'] = 'new_value'
Пример
Давайте создадим таблицу и добавим к ней метаданные:
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3, 4, 5],
'b': [10, 20, 30, 40, 50]
})
df.attrs['description'] = 'Sample dataset'
df.attrs['created'] = '2026-09-09'
df.attrs['version'] = 1.0
print(df.attrs)
Результат выполнения кода:
{'description': 'Sample dataset', 'created': '2026-09-09', 'version': 1.0}
Пример
Давайте получим значение конкретного ключа из метаданных:
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3, 4, 5],
'b': [10, 20, 30, 40, 50]
})
df.attrs['author'] = 'Data Analyst'
df.attrs['source'] = 'experiment.csv'
print(df.attrs['author'])
print(df.attrs.get('source'))
Результат выполнения кода:
"Data Analyst"
"experiment.csv"
Пример
Давайте обновим существующие метаданные и добавим новые:
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3, 4, 5],
'b': [10, 20, 30, 40, 50]
})
df.attrs['version'] = 1
df.attrs['notes'] = 'Initial version'
# Обновление значения
df.attrs['version'] = 2
df.attrs['notes'] = 'Updated version'
print(df.attrs)
Результат выполнения кода:
{'version': 2, 'notes': 'Updated version'}
