Query a Firestore collection with a string eq filter (async)
Stay organized with collections
Save and categorize content based on your preferences.
Query a Firestore collection with a string eq filter (async).
Explore further
For detailed documentation that includes this code sample, see the following:
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis content demonstrates how to query a Firestore collection using a string equality filter in Python asynchronously.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to Firestore is required, using Application Default Credentials, as detailed in the provided documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe example utilizes \u003ccode\u003eFieldFilter\u003c/code\u003e to filter the "cities" collection where the "state" field is equal to "CA".\u003c/p\u003e\n"],["\u003cp\u003eMore information on performing simple and compound queries is provided in the documentation, accessible via the provided links.\u003c/p\u003e\n"],["\u003cp\u003eThe sample code can be used to query and filter data and more examples can be found in the google cloud sample browser.\u003c/p\u003e\n"]]],[],null,["# Query a Firestore collection with a string eq filter (async).\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Perform simple and compound queries in Cloud Firestore](https://firebase.google.com/docs/firestore/query-data/queries)\n- [Query and filter data](/firestore/native/docs/query-data/queries)\n\nCode sample\n-----------\n\n### Python\n\n\nTo authenticate to Firestore, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n # Create a reference to the cities collection\n cities_ref = db.collection(\"cities\")\n\n # Create a query against the collection\n query_ref = cities_ref.where(filter=FieldFilter(\"state\", \"==\", \"CA\"))\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=firestore)."]]
