{"id": "internals:database-results", "page": "internals", "ref": "database-results", "title": "Results", "content": "The  db.execute()  method returns a single  Results  object. This can be used to access the rows returned by the query. \n                 Iterating over a  Results  object will yield SQLite  Row objects . Each of these can be treated as a tuple or can be accessed using  row[\"column\"]  syntax: \n                 info = []\nresults = await db.execute(\"select name from sqlite_master\")\nfor row in results:\n    info.append(row[\"name\"]) \n                 The  Results  object also has the following properties and methods: \n                 \n                     \n                         .truncated  - boolean \n                         \n                             Indicates if this query was truncated - if it returned more results than the specified  page_size . If this is true then the results object will only provide access to the first  page_size  rows in the query result. You can disable truncation by passing  truncate=False  to the  db.query()  method. \n                         \n                     \n                     \n                         .columns  - list of strings \n                         \n                             A list of column names returned by the query. \n                         \n                     \n                     \n                         .rows  - list of  sqlite3.Row \n                         \n                             This property provides direct access to the list of rows returned by the database. You can access specific rows by index using  results.rows[0] . \n                         \n                     \n                     \n                         .first()  - row or None \n                         \n                             Returns the first row in the results, or  None  if no rows were returned. \n                         \n                     \n                     \n                         .single_value() \n                         \n                             Returns the value of the first column of the first row of results - but only if the query returned a single row with a single column. Raises a  datasette.database.MultipleValues  exception otherwise. \n                         \n                     \n                     \n                         .__len__() \n                         \n                             Calling  len(results)  returns the (truncated) number of returned results.", "breadcrumbs": "[\"Internals for plugins\", \"Database class\"]", "references": "[{\"href\": \"https://docs.python.org/3/library/sqlite3.html#row-objects\", \"label\": \"Row objects\"}]"}