pandas.read_sas

pandas.read_sas(filepath_or_buffer, *, format=None, index=None, encoding=None, chunksize=None, iterator=False, compression='infer')[source]

Чтение файлов SAS в формате XPORT или SAS7BDAT.

Параметры:

filepath_or_buffer:строка, объект пути или объект файла

Строка, объект пути (реализующий os.PathLike[str]), или объект файла, реализующий двоичную read() функцию. Строка может быть URL-адресом. Допустимые схемы URL-адресов включают http, ftp, s3 и file. Для URL-адресов файлов ожидается хост. Локальный файл может быть: file://localhost/path/to/table.sas7bdat.

format:строка {‘xport’, ‘sas7bdat’} или None

Если None, формат файла определяется по расширению файла. Если ‘xport’ или ‘sas7bdat’, используется соответствующий формат.

index:идентификатор столбца индекса, по умолчанию None

Идентификатор столбца, который должен использоваться в качестве индекса DataFrame.

encoding:строка, по умолчанию None

Кодировка текстовых данных. Если None, текстовые данные хранятся как сырые байты.

chunksize:целое число

Считывает файл по chunksize строкам за раз, возвращает итератор.

iterator:булево значение, по умолчанию False

Если True, возвращает итератор для постепенного чтения файла.

compression:строка или словарь, по умолчанию ‘infer’

Для сжатия данных на диске на лету. Если ‘infer’ и ‘filepath_or_buffer’ — объект пути, то обнаружение сжатия происходит по следующим расширениям: ‘.gz’, ‘.bz2’, ‘.zip’, ‘.xz’, ‘.zst’, ‘.tar’, ‘.tar.gz’, ‘.tar.xz’ или ‘.tar.bz2’ (иначе без сжатия). При использовании ‘zip’ или ‘tar’ ZIP-архив должен содержать только один файл данных для чтения. Установлено в None для отсутствия сжатия. Также может быть словарь с ключом 'method', установленным в одном из {'zip', 'gzip', 'bz2', 'zstd', 'xz', 'tar'}, а другие пары ключ-значение передаются в zipfile.ZipFile, gzip.GzipFile, bz2.BZ2File, zstandard.ZstdDecompressor, lzma.LZMAFile или tarfile.TarFile, соответственно. Например, для сжатия Zstandard с использованием пользовательского словаря сжатия можно передать следующее: compression={'method': 'zstd', 'dict_data': my_compression_dict}.

New in version 1.5.0: Добавлена поддержка файлов .tar.

Возвращаемое значение:

DataFrame, если iterator=False и chunksize=None, в противном случае SAS7BDATReader

или XportReader

Примеры

>>> df = pd.read_sas("sas_data.sas7bdat")